C 语言注释

注释面向开发者阅读，编译器会直接忽略这部分内容。注释不会影响程序运行，却直接决定代码是否易于理解，哪怕是时隔许久、回头维护代码的自己。我们先从基础写法开始介绍。

什么是注释

注释是嵌入代码中、会被编译器忽略的说明文本。它不会影响程序运行，仅用于帮助开发者理解代码。有无注释不影响程序执行，但写好注释是专业开发的基本素养。

单行注释

单行注释用双斜杠 // 开头，从 // 到这一行结束的内容都是注释：

#include <stdio.h>

int main() {
    // 打印信息
    printf("Hello C");
    return 0;
}

输出：

Hello C

也可以放在语句后面，同一行内解释这一句在干什么的：

printf("Hello C");  // 打印信息

多行注释

多行注释用 /* ... */ 包裹，可以跨多行。注意它不能嵌套，也就是说注释里不能再包含 /* */：

/*
要注释
的代码
*/
printf("Hello C");  // 打印信息

完整示例：

#include <stdio.h>

int main() {
    /* 打印信息
       多行注释 */
    printf("Hello C");
    return 0;
}

输出：

Hello C

注释的用法习惯

• 注释应当解释为什么，而不是描述是什么：代码本身已经体现了它的功能，注释更适合说明这么做的原因、潜在隐患。
• 给函数与复杂逻辑编写文档注释：在函数头部添加注释，说明参数、返回值以及使用注意事项。
• 临时屏蔽代码：调试阶段可用注释停用一段代码，相比删除代码，后续恢复更加方便。
• 不要写冗余注释：像 int i; // 声明i 这类没有有效信息的注释，不如不写。

注释不存在刻板的标准规范，多看他人代码、坚持动手书写，慢慢就能找到合适的尺度。拿不定主意时不妨自问：时隔两个月再来阅读这段代码，能否一眼理清逻辑。如果心存疑虑，就补充一行注释。