C++ 编码风格¶

此文件使用 C++ 特定内容扩展 common/coding-style.md。

现代 C++（C++17/20/23）¶

• 优先使用现代 C++ 特性，而不是 C 风格语法
• 当上下文能明确类型时，使用 auto
• 对编译期常量使用 constexpr
• 使用结构化绑定：auto [key, value] = map_entry;

资源管理¶

• 彻底使用 RAII — 禁止手动 new/delete
• 独占所有权使用 std::unique_ptr
• 仅在确实需要共享所有权时使用 std::shared_ptr
• 使用 std::make_unique / std::make_shared 代替原始 new

命名规则¶

• 类型/类：PascalCase
• 函数/方法：snake_case 或 camelCase（遵循项目约定）
• 常量：kPascalCase 或 UPPER_SNAKE_CASE
• 命名空间：lowercase
• 成员变量：snake_case_（末尾下划线）或 m_ 前缀

格式化¶

• 使用 clang-format — 无需讨论风格
• 提交前运行 clang-format -i <file>

参考¶

关于全面的 C++ 编码标准和指南，请参见技能：cpp-coding-standards。