文章目录
程序入门设计 — C 语言
第二周 核心语法
📝2.1 C 语言笔记 | 注释的使用(让代码会“说话”)
💡 注释的作用
- 解释代码:用人类语言说明代码逻辑(比如“这段代码计算用户年龄”)。
- 提高可读性:让其他人(或未来的自己)快速理解代码意图。
- 临时禁用代码:调试时注释掉部分代码,避免删除后找不到。
🔍 注释的两种写法
单行注释:
// 注释内容
作用:注释从
//
开始到行尾的内容。示例:
#include <stdio.h> int main() { // 输出欢迎语 printf("Hello World!\n"); // 打印后换行 return 0; }
多行注释:
/* 注释内容 */
作用:注释从
/*
开始到*/
结束的内容,可跨多行。示例:
#include <stdio.h> int main() { /* 这是多行注释 可以写很多行说明 比如解释程序功能 */ printf("Hello World!\n"); return 0; }
⚠️ 注释的注意事项
注释不能嵌套
❌ 错误写法:
/* 外层注释 /* 内层注释 */ // 这里会报错! */
✅ 正确写法:
/* 外层注释 */ // 单行注释
注释符号后加空格
(可选但推荐)
✅ 更好读:
// 输出结果 printf("Hello!\n");
❌ 不推荐:
//输出结果 printf("Hello!\n");
避免过度注释
❌ 冗余注释:
c int a = 5; // 定义变量a并赋值为5
✅ 必要注释:
c int days_in_feb = 28; // 平年2月天数(闰年需特殊处理)
🔧 注释的实用场景
解释复杂逻辑
// 计算阶乘(n! = n*(n-1)*...*1) int factorial = 1; for (int i = 1; i <= n; i++) { factorial *= i; }
标记待办事项
// TODO: 优化输入验证逻辑(当前未处理负数) scanf("%d", &num);
临时禁用代码
#include <stdio.h> int main() { // printf("这行被注释了,不会执行"); printf("只有这行会执行\n"); return 0; }
📌 本节总结:
- 💡 注释是写给人的:代码是给机器执行的,注释是给人理解的。
- 🔍 适度原则:简单代码无需注释,复杂逻辑必须解释。
- 💻 动手实践:给之前的代码添加注释,再试着用注释禁用某行代码,观察运行结果!
下节预告:关键字(保留字)深度解析 🚀