C++ 程序可视化教程 · 第5课 · 第一章 程序

C++ 注释怎么写？// 和 /* */ 的区别

两种注释

#include <iostream>
using namespace std;

/*
 * 程序功能：输出一句问候
 */
int main() {
    // 输出问候语
    cout << "你好！" << endl;
    return 0;
}

单行注释 //：从 // 到行尾均为注释。可独占一行，也可跟在代码之后。

多行注释 /* */：从 /* 到 */ 均为注释，可以跨行。典型用途是文件头部的说明块，以及临时停用整段代码。

注释的真正用途

初学者容易把注释写成代码的复读：

int a = 6;   // 定义变量a并赋值为6 —— 无效注释，代码本身已经说明

有价值的注释写的是代码中看不出来的信息——为什么这样做、有什么约束：

int maxScore = 100;  // 规则上限，超出按 100 计

判断标准：遮住代码只看注释，能理解程序为什么这样设计，注释就是合格的。

用注释调试

调试时验证「去掉这行会怎样」，不必删除代码，用注释将其停用：

// cout << a << endl;   暂时不输出 a

这行代码仍在文件中，但编译器将其忽略，恢复时去掉 // 即可。这是调试阶段的常用手法。

常见错误

• /* */ 漏写收尾：缺少 */ 时后续代码全部被注释，报错位置往往远离真正的问题；
• /* */ 嵌套：/* ... /* ... */ ... */ 不成立，第一个 */ 即结束注释；
• 误认为字符串中的 // 是注释："http://..." 中的 // 是字符串内容，编译器不会把它当注释。

至此第一章结束：程序的结构、编译与运行的关系、头文件、名字空间、注释。下一章进入变量——变量监视区将从那里开始有内容。

在 CppStudio 里打开本课示例，亲手运行 →

常见问题