【C语言】C 语言编码风格（基于 ISO/IEC 9899:2024 和 Linux 内核编码风格 v6.13.0-rc4）

LuckiBit

C 语言的编码风格对于编写清晰、可维护、易于调试的代码至关重要。本文将结合 ISO/IEC 9899:2024 (N3220) 标准（即 C23 标准）和 Linux 内核编码风格 v6.13.0-rc4，全面讲解 C 语言编码规范。这两个文献代表了行业中的两个重要编码风格，本文将结合它们的规则和最佳实践进行对比分析，并提供代码示例。

1. 缩进与空格

1.1 缩进

规范出自：

• ISO/IEC 9899:2024 (N3220)：第 6.5.2 节，第 9 行。
• Linux内核文档：第 2 节，第 14 行。

示例：

Linux 内核风格：

if (condition) {
        do_something();
} else {
        do_something_else();
}

C23 标准（建议）：

if (condition) {
    do_something();
} else {
    do_something_else();
}

1.2 空格的使用

规范出自：

• ISO/IEC 9899:2024 (N3220)：第 6.5.8 节，第 2 行。
• Linux内核文档：第 2 节，第 16 行。

示例：

Linux 内核风格：

s = sizeof(struct file);  // sizeof 后不加空格
a = b + c;                 // 运算符两侧加空格

C23 标准（建议）：

s = sizeof(struct file);  // sizeof 后不加空格
a = b + c;                 // 运算符两侧加空格

2. 行长

规范出自：

• ISO/IEC 9899:2024 (N3220)：第 6.1 节，第 12 行。
• Linux内核文档：第 2 节，第 19 行。

示例：

Linux 内核风格：

printf("This is a long line, which should be broken into two lines "
       "to avoid exceeding the 80-character limit.");

C23 标准（建议）：

printf("This is a long line, which should be broken into two lines "
       "to avoid exceeding the 100-character limit.");

3. 变量与命名

3.1 变量命名

规范出自：

• ISO/IEC 9899:2024 (N3220)：第 6.3.1 节，第 5 行。
• Linux内核文档：第 3 节，第 8 行。

示例：

Linux 内核风格：

int max_buffer_size;

C23 标准（建议）：

int max_buffer_size;

3.2 宏命名

规范出自：

• ISO/IEC 9899:2024 (N3220)：第 6.3.1 节，第 9 行。
• Linux内核文档：第 5 节，第 4 行。

示例：

Linux 内核风格：

#define MAX_BUFFER_SIZE 1024

C23 标准（建议）：

#define MAX_BUFFER_SIZE 1024

4. 数据结构

4.1 结构体定义

规范出自：

• ISO/IEC 9899:2024 (N3220)：第 6.5.6 节，第 6 行。
• Linux内核文档：第 3 节，第 8 行。

示例：

Linux 内核风格：

struct file {
    struct inode *inode;
    unsigned long f_flags;
    char *f_path;
};

C23 标准（建议）：

struct file {
    struct inode *inode;
    unsigned long f_flags;
    char *f_path;
};

4.2 枚举定义

规范出自：

• ISO/IEC 9899:2024 (N3220)：第 6.4.4 节，第 8 行。
• Linux内核文档：第 4 节，第 4 行。

示例：

Linux 内核风格：

enum file_flags {
    O_RDONLY,
    O_WRONLY,
    O_RDWR
};

C23 标准（建议）：

enum file_flags {
    O_RDONLY,
    O_WRONLY,
    O_RDWR
};

5. 运算符与表达式

5.1 运算符使用

规范出自：

• ISO/IEC 9899:2024 (N3220)：第 6.5.8 节，第 2 行。
• Linux内核文档：第 2 节，第 16 行。

示例：

Linux 内核风格：

s = sizeof(struct file);  // sizeof 后不加空格
a = b + c;                 // 运算符两侧加空格

C23 标准（建议）：

s = sizeof(struct file);  // sizeof 后不加空格
a = b + c;                 // 运算符两侧加空格

6. 注释

6.1 单行注释

规范出自：

• ISO/IEC 9899:2024 (N3220)：第 6.1.3 节，第 10 行。
• Linux内核文档：第 6 节，第 6 行。

示例：

Linux 内核风格：

int value = 10; // 设置初始值为10

C23 标准（建议）：

int value = 10; // 设置初始值为10

6.2 多行注释

规范出自：

• ISO/IEC 9899:2024 (N3220)：第 6.1.3 节，第 10 行。
• Linux内核文档：第 6 节，第 7 行。

示例：

Linux 内核风格：

/*
 * 这是一个多行注释，描述代码的功能。
 * 这里继续说明该部分代码的作用。
 */

C23 标准（建议）：

/*
 * 这是一个多行注释，描述代码的功能。
 * 这里继续说明该部分代码的作用。
 */

7. 函数与流程控制

7.1 函数定义

规范出自：

• ISO/IEC 9899:2024 (N3220)：第 6.9.1 节，第 4 行。
• Linux内核文档：第 7 节，第 5 行。

示例：

Linux 内核风格：

static int my_function(int a, int b)
{
    return a + b;
}

C23 标准（建议）：

int add(int a, int b)
{
    return a + b;
}

7.2 流程控制语句（if/else）

规范出自：

• ISO/IEC 9899:2024 (N3220)：第 6.8.4 节，第 4 行。
• Linux内核文档：第 8 节，第 9 行。

示例：

Linux 内核风格：

if (condition) {
    do_something();
} else {
    do_something_else();
}

C23 标准（建议）：

if (condition) {
    do_something();
} else {
    do_something_else();
}

8. 错误处理与返回值

8.1 错误处理

规范出自：

• ISO/IEC 9899:2024 (N3220)：第 7.19 节，第 2 行。
• Linux内核文档：第 9 节，第 4 行。

示例：

Linux 内核风格：

if (error_condition) {
    pr_err("Error occurred: %d\n", error_code);
    return -EINVAL;
}

C23 标准（建议）：

if (error_condition) {
    perror("Error occurred");
    return -1;
}

9. 内存管理

9.1 动态内存分配

规范出自：

• ISO/IEC 9899:2024 (N3220)：第 7.10 节，第 5 行。
• Linux内核文档：第 10 节，第 2 行。

示例：

Linux 内核风格：

int *ptr = kmalloc(sizeof(int) * 10, GFP_KERNEL);
if (!ptr) {
    pr_err("Memory allocation failed\n");
    return -ENOMEM;
}
kfree(ptr);

C23 标准（建议）：

int *ptr = malloc(sizeof(int) * 10);
if (ptr == NULL) {
    perror("Memory allocation failed");
    return -1;
}
free(ptr);

10. 总结

C 语言的编码风格标准在许多方面有相似之处，特别是在变量命名、函数定义、注释和代码结构方面。ISO/IEC 9899:2024 (N3220)（即 C23 标准）提供了一些通用的编码建议，而 Linux 内核编码风格 则更多关注内核代码的性能和可维护性。

• 缩进和空格：Linux 内核风格使用制表符进行缩进，而 C23 标准推荐使用空格，通常为 4 个空格。
• 行长：C23 标准建议每行不超过 100 个字符，Linux 内核风格则要求 80 个字符以内。
• 命名约定：两者都推荐使用小写字母和下划线（snake_case）来命名变量和函数。
• 注释：对于单行和多行注释，两者都使用 // 和 /* */，强调简洁明了。

这些规范可以帮助开发者编写更整洁、易于阅读和维护的 C 语言代码，特别是在多团队协作的项目中。

11. 参考文献：

1. ISO/IEC 9899:2024 (N3220) — C23标准文档的最新版本：
   • ISO/IEC 9899:2024 (N3220) C Programming Language
2. Linux内核编码风格 v6.13.0-rc4：
   • Linux Kernel Coding Style v6.13.0-rc4

12. 结束语

1. 本节内容已经全部介绍完毕，希望通过这篇文章，大家对C语言的编码风格有了更深入的理解和认识。
2. 感谢各位的阅读和支持，如果觉得这篇文章对你有帮助，请不要吝惜你的点赞和评论，这对我们非常重要。