该技能是一份面向 C 语言的惯用写法与效率参考,用于在编写或审查 C 代码时提供语言层面的具体建议。资料说明其适用范围为“Language-specific super-code guidelines for c”,即 C 语言专属的编码指引。
使用方式与约束:仅在请求范围内并遵循当前项目约定时应用;需保留原有行为、所有权、错误处理、可访问性与安全性;文中示例是独立片段,并非在所有上下文中都等价的改写;应核对语言与库版本并运行相关检查;必需的测试以及面向用户的进度与结果优先于简洁性规则;不得仅为遵循示例而安装依赖或删除文件。
主要内容按主题组织:
内存管理:检查 malloc 返回值;避免强制转换 malloc 结果;使用 sizeof *ptr 而非 sizeof(Type);释放后将指针置空;在提前返回路径上使用单一 cleanup 标签统一释放资源。
指针与数组:传递指针时同时传递长度或使用包含数据与长度的结构体;优先使用数组索引而非指针算术;避免在生产代码中使用变长数组(VLA),改用堆分配并检查尺寸溢出。
错误处理:使用具名错误码而非魔法数字;在函数文档说明设置 errno 时保存 errno;用提前返回或 goto cleanup 替代深层嵌套错误检查,并指出 goto cleanup 是 C 中资源清理的惯用方式。
字符串:避免无边界检查的 strcpy,使用 strncpy 并确保终止符或优先 snprintf;用 strcmp 比较内容而非指针;避免重复 strcat 造成 O(n²),改为跟踪写入位置;始终优先 snprintf 而非 sprintf。
结构体与枚举:使用 typedef 简化结构体使用;初始化结构体避免未定义行为;用枚举替代魔法整数常量。
预处理器与头文件:能用 static inline 函数时不用宏,以避免类型不安全与重复求值;头文件使用包含守卫或 #pragma once;宏保留用于条件编译与常量。
C 特有反模式:列出 sprintf、gets、强制转换 malloc 结果、sizeof(Type)、大尺寸 VLA、无上下文参数的回调、全局可变状态、用 assert 处理运行时错误、只读指针参数缺少 const、有符号与无符号混用比较等,并给出首选做法。
限制:资料明确说明这些是语言专属指引,不覆盖整体架构决策;过度压缩可能降低可读性,需自行判断。资料未提供安装命令、依赖要求、收费或平台信息。