C++ 代码规范指南

本指南为 C++ 开发人员提供一套全面的代码规范,以提高代码可读性、可维护性和可靠性。

1. 命名规范

  • 类名使用大驼峰命名法(CamelCase)。
  • 函数名和变量名使用小驼峰命名法(camelCase)。
  • 常量使用全大写字母,单词之间用下划线分隔(CONSTANT_NAME)。
  • 私有成员变量以下划线结尾(_member_variable)。

2. 代码格式

  • 使用 4 个空格进行缩进。
  • 每行代码不超过 80 个字符。
  • 在运算符两侧添加空格。
  • 使用空行分隔逻辑代码块。

3. 注释规范

  • 使用清晰简洁的注释解释代码逻辑。
  • 避免添加冗余注释。
  • 使用 Doxygen 格式编写文档注释。

4. 错误处理

  • 使用异常处理机制处理运行时错误。
  • 避免使用返回值来指示错误状态。
  • 提供详细的错误信息,以便于调试。

5. 其他建议

  • 使用 const 关键字声明不可变的值。
  • 避免使用全局变量。
  • 遵循 RAII 原则(资源获取即初始化)。
  • 使用智能指针管理内存。

总结

遵循一致的代码规范对于开发高质量的 C++ 代码至关重要。本指南提供了一套通用的规范,可根据项目需求进行调整。

pdf 文件大小:8.31MB