在C语言中，注释是程序中不可或缺的一部分。它能为程序员提供更好的代码理解和维护，同时也不会影响程序的运行。C语言中提供了两种注释方式，单行注释和多行注释。

单行注释

单行注释使用//在代码中添加注释，注释内容从//开始直到该行结束。这种注释适用于添加行内说明。

#include <stdio.h>

int main() {
    printf("Hello, World!"); // 输出"Hello, World!"到屏幕
    return 0;
}

多行注释

多行注释使用/* */在代码中添加注释，注释内容从/*开始一直到*/结束。这种注释适用于添加多行说明。

#include <stdio.h>

int main() {
    printf("Hello, World!"); /* 输出"Hello, World!"到屏幕 */
    return 0;
}

条件编译中的注释

除了基本的单行注释和多行注释外，C语言中还提供了预处理器指令#ifdef、#ifndef、#endif等用于条件编译的注释。这些指令可以控制程序中某些代码块的选择性编译。

#include <stdio.h>
#define DEBUG // 定义DEBUG宏，用于开启或关闭调试模式

int main() {
    printf("Hello, World!");
    #ifdef DEBUG  // 如果定义了DEBUG宏，则输出调试信息
        printf("Debug mode is enabled.");
    #endif
    return 0;
}

总结

C语言中的注释是程序中不可或缺的一部分，可以使代码更加易读易理解，提高可维护性。除了基本的单行注释和多行注释，C语言中的条件编译也可以用于注释代码块的选择性编译。

有哪些实用的注释技巧？

除了基本的单行注释和多行注释外，还有一些实用的注释技巧可以帮助你更好地编写代码：

①用注释记录函数的参数和返回值

将函数的参数和返回值写在注释中，可以使其他程序员更容易地理解函数的用途和作用，提高代码可读性：

/**
 * @brief 计算两数之和
 *
 * @param[in] a 加数
 * @param[in] b 加数
 *
 * @return 两数之和
 */
int add(int a, int b) {
    return a + b;
}

②用注释帮助调试

在测试和调试代码时，将一些思路或标记写在注释中，可以使调试过程更加高效。

#include <stdio.h>

int main() {
    int a = 1;
    int b = 2;
    int c = a + b; // 程序运行到这里，我们来观察c的值
    printf("c = %d", c);
    return 0;
}

③注释占位符

在待完成的代码处用注释占位符代替，可以让代码更加醒目，更加易于维护：

#include <stdio.h>

int main() {
    int a = 1;
    int b = 2;
    int c; //TODO：计算a和b的积，并存储到c中
    printf("c = %d", c);
    return 0;
}

注释虽然不能直接被机器编译，但却是程序不可或缺的一部分，能提供重要的信息和帮助，让程序更加易读易理解。我们应该在编写代码时充分利用注释，使程序变得更加可维护和易于扩展。

如果你有其他关于C语言注释方面的疑问或想法，欢迎在下面留言，与我们一起探讨。

感谢阅读！

如果你喜欢这篇文章，请点赞、评论和分享。

更多干货内容，请关注我们的公众号。