Skip to main content

第3章 程序的注释

注释仅用于阅读说明,编译器完全忽略,不会执行

3.1 注释作用

  1. 解释代码逻辑、思路,方便自己和他人阅读;
  2. 临时屏蔽一段代码,调试对比效果;
  3. 提升可维护性,方便后期修改。

3.2 两类注释

3.2.1 单行注释 //

//开始,到本行末尾全部为注释

//输出hello
cout<<"hello";
int a = 10; //定义变量a

3.2.2 多行注释 /* ... */

/*开始,*/结束,中间可以跨多行。

/*
这是多行注释
可以写很多行说明文字
*/

多行注释不能嵌套多行注释

/*
外层注释
/* 内层多行注释,这里语法错误 */
*/

✅ 单行注释可以写在多行注释内部。

3.3 使用注意

  1. 不要过度注释,简单易懂代码不需要重复写注释;
  2. 修改代码,同步更新注释,避免注释和代码不一致;
  3. /**/必须成对,少写一个会造成大片代码被误注释;
  4. C++支持///* */;C99之后C语言也支持单行注释。