CentOS C++代码风格有哪些规范

CentOS C++代码风格要点

总体原则

• 在 CentOS 生态中，C++ 项目通常沿用上游社区或公司统一的风格指南，核心目标是一致性与可读性。团队应选定一套风格并用工具固化，例如提供 .clang-format 文件，并在 VS Code、CLion、Visual Studio、Vim/Xcode 等 IDE 中启用自动格式化，确保提交前代码风格统一。

头文件与包含管理

• 头文件使用包含守卫（#ifndef/#define/#endif），命名建议采用**项目_路径_文件名_H_**的大写下划线风格，避免重复包含与命名冲突。
• 包含顺序建议分层清晰：相关头文件优先（如同一模块的头文件）、C 系统头文件、C++ 系统头文件、第三方库头文件、本项目头文件；这样能减少隐藏依赖并提升可读性。
• 尽量减少不必要的头文件依赖，优先使用前向声明；将声明与定义分离（头文件放声明，源文件放定义），有助于缩短编译时间并降低耦合。
• 标准库头文件用尖括号（如 ），项目头文件用双引号（如 “myclass.h”）。

命名与文件组织

• 命名风格保持全库一致，常见有CamelCase与snake_case两种；选择其一并在整个项目贯彻。
• 常见约定：
  • 类/类型以大写字母开头（如 MyClass）。
  • 函数/变量以小写字母开头（如 myFunction, myVar）。
  • 常量全大写（如 MAX_SIZE）。
  • 宏全大写加下划线（如 INT_MAX）。
  • 模板参数常用驼峰（如 InputIterator）。
  • 为区分作用域，可约定私有成员前缀 m_、函数参数前缀 t_（团队内统一即可）。
• 文件命名与目录结构建议小写、语义清晰，避免特殊符号；头文件与源文件配对管理，目录层次体现模块边界。

格式与排版

• 缩进与空格：选择2 或 4 个空格并在全库统一；关键字（如 if/for/while/case）后留一个空格；函数名后不留空格；二元操作符（如 =, +, ==, &&）两侧留空格；一元操作符（如 !, ~, ++）与操作数之间不留空格；括号、逗号、分号紧跟其前一项，括号内不插入多余空格。
• 大括号与空行：左大括号 { 通常独占一行并与控制语句对齐；右大括号 } 单独成行；类/函数声明或定义结束后空一行；函数体内逻辑紧密的语句之间不加空行，逻辑段落之间加空行分隔。
• 行长与换行：单行建议控制在70–80 个字符；长表达式在低优先级操作符处换行，并将操作符置于行首以突出优先级；换行后适当缩进，保持对齐。
• 声明与初始化：遵循就近初始化与一行一条语句，提升可读性与安全性。

语言特性与可维护性

• 作用域与命名空间：优先在源文件中使用匿名命名空间或 static 限制符号可见性；具名命名空间基于项目名/相对路径组织，文件内容（除包含与前置声明外）尽量置于命名空间内；禁止使用 using 指示（using namespace xxx）污染全局命名空间；不要在 std 命名空间中声明任何实体；头文件中谨慎使用命名空间别名。
• 类设计：构造函数中不要调用虚函数，避免在无法报告错误时进行可能失败的初始化；对单参数构造函数与转换运算符使用 explicit 禁止隐式转换；若类型不需要拷贝/移动，显式禁用相应特殊成员函数。
• 内联与包含：仅当函数体**很小（如 ≤10 行）**时再考虑 inline，以避免代码膨胀与调试困难。
• 工具与质量保障：使用 clang-format 统一格式，结合 cpplint 等静态检查工具执行规则校验；在提交前通过预提交钩子或 CI 自动检查，降低风格漂移与低级错误。