小古银的官方网站（完整教程）：http://www.xiaoguyin.com/
C++入门教程视频：https://www.bilibili.com/video/av20868986/
当写了很多年代码之后，会逐渐出现以下问题：
- 很多年前写的代码，现在竟然看不懂，还要重新把代码看一遍。
- 工作的时候，经常是团队合作，如果别人只发了一大段代码给你用，你看不懂还是要从头看一遍。
- 你写库的时候，别人看不懂。
等等这些情况。
这时就需要在代码附近写一些文字进行说明，这些文字叫做注释。
注意：注释在编译的时候，编译器会将注释去掉，再编译程序，所以注释并不会编译到程序中，不会使程序变慢变大。
先看以下示例：
int main(void)
{
// 这是行注释, 用来注释一行
// 编译器会忽略掉注释部分
/*多行注释*/
/*注释是用来给人看的,
例如你写了代码, 半年后发现Bug,
如果你不写注释, 你会体会到因为看
不懂代码而从头开始看代码的痛苦了*/
return 0;
}
看到上面例子，聪明的你肯定也知道怎样写注释了。
如果注释只有一行，在注释前面写//即可；也可以使用/**/在中间写注释。
如果是多行，可以在每行注释前都加上//；也可以使用/**/在中间写很多行注释。
注释的格式有很多种，一般听从项目领导人安排。不过也有几条常用规则的：
- 不是每行都写注释，在一段小功能的上面写注释，让人一看就知道这小段代码做了什么。
- 例如变量，别人不知道变量在后面代码中做什么，可以在每个变量右面简短注释这个变量后面是怎么用。
- 注释都写在需要注释代码的上面和右面。
由于这个C++教程是给初学者看的，所以我基本上会在每行后面添加注释，给初学者说明白。这样，注释就起到它应该有的作用。而实际工作中，都不会是初学者，一些基本的常识并不需要写注释，因为大家都懂，这时写注释反而并不好。多写注释是个好习惯。
网友评论