c#小灶——4.注释和代码规范

为何要写注释?

早上我写完了代码,我和个人朋友们都能看懂,到了晚上,我还能看懂,一周后,就只有上帝能看懂了……html

  1. 未来咱们写的代码量是很大的,代码又不像咱们天然语言这么好理解,可能过段时间咱们就不认识本身的代码了,因此咱们要养成写注释的好习惯。
  2. 团队合做当中,写了注释更容易使别人读懂你的代码。
  3. 注释的做用除了解释说明,还有一个比较经常使用,由于注释不被编译的特性,咱们常常会把一些暂时用不到的代码注释掉,这样的话若是忽然须要就能够拿来用了。若是删掉了,再用就只能从新写了。 

注释的原理

  咱们在代码当中写注释,只会方便咱们理解,真正编译的时候,编译器会跳过注释的部分,因此写注释不会对咱们的程序产生任何影响。它只是给人看的,机器不看。学习

如何写注释

单行注释

单行注释的写法是//,//后面的内容都不会被编译spa

多行注释

多行注释的写法是以/*开头,以*/结尾,它们中间的内容不会被编译。代码规范

文档注释

文档注释这个比较特殊,由于它的目的是生成一份程序的说明文档,因此它会被编译,可是不会被执行。单行注释和多行注释能够写在任何地方,文档注释只能写在类和方法的前面。htm

代码规范

通过这几天的学习,大家应该能发现个人代码都是有缩进的,若是不缩进行不行?从技术上说,行。
大家也能看到我都是一行只写一条语句,那我写多条行不行?从技术上说,也没问题。
但是你想过吗?未来咱们要写的代码是不少的,因此必定要规范,这样未来读起来才更容易,维护起来也更简单。因此必定要有缩进,要井井有条,一行只写一条语句,上下的大括号要对齐,变量名字要见名知意…… 
养成好习惯,从如今作起。

快捷键

  1. 快速排版代码 ctrl+K接着ctrl+D。对齐啊缩进啊什么的都要规范的,vs提供了一个功能就是快速排版,若是代码乱了按一下快捷键,就有条理多了。
  2. 注释所选代码 ctrl+K接着ctrl+C。先选中须要注释的代码,一行或者多行,而后使用这个快捷键。至关于在选中的每行代码前自动添加//。
  3. 取消注释代码 ctrl+K接着ctrl+U。若是有批量被注释的代码,用此快捷键至关于去掉选中的每行代码前的//。 

原文出处:https://www.cnblogs.com/hmswt/p/11298986.htmlblog

相关文章
相关标签/搜索