17370845950

C++ Core Guidelines 是由 Stroustrup 与 Sutter 发起、全球工程师维护的现代 C++ 工程最佳实践指南，强调安全、高效、可维护，聚焦资源管理、类型安全、模块化和性能约束，并通过静态分析、CI/CD 和编译器属性实现落地。

C++ Core Guidelines 是由 C++ 之父 Bjarne Stroustrup 与 Herb Sutter 共同发起、由全球一线 C++ 工程师持续维护的一套权威性、实践导向的编码规范集合。它不是标准，也不是强制语言规则，而是一套面向现代 C++（C++11 及以后）的工程化最佳实践指南，目标是帮助开发者写出更安全、更高效、更可维护、更易理解的 C++ 代码。

它强调“零成本抽象”与“显式优于隐式”，拒绝以便利性牺牲可控性，所有建议均基于真实项目痛点、编译器行为、硬件特性与静态分析能力演进。

核心定位：不是教你怎么写 Hello World，而是教你怎么写不出错的系统级代码

• 不替代标准：不定义语法，不规定标准库用法细节，而是补充标准未覆盖的工程决策层问题
• 工具友好：每条准则都尽可能支持静态分析工具（如 clang-tidy、CppCoreCheck）自动检测
• 渐进采用：允许按项目节奏分阶段落地，例如先启用资源管理类规则，再推进模块化迁移

关键规范方向（2025 年最新重点）

✅ 资源管理：杜绝裸指针与手动释放

• 禁止 new/delete 直接调用，强制使用 std::unique_ptr / std::shared_ptr
• 所有 RAII 类必须显式声明移动语义，禁止意外拷贝（= delete 拷贝构造与赋值）
• 文件句柄、锁、GPU 内存等非内存资源，也需封装为 RAII 类型（如 ConnectionGuard, CudaMemoryGuard）

✅ 类型安全与错误处理：让错误路径不可忽略

• 系统调用、I/O、配置加载等可能失败的操作，统一返回 std::expected
• 禁用 throw 在性能关键路径（如内核函数、中断处理、实时循环）中出现
• 前置条件（precondition）和后置条件（postcondition）须用 C++23 Contracts 显式标注，而非注释或断言

✅ 模块化与接口设计：终结头文件地狱

• 新项目默认启用 C++20 Modules，.cppm 或 .ixx 为模块接口单位
• 每个模块导出最小必要符号，禁止通过 #include 泄漏实现细节或第三方头文件
• 模块间依赖通过抽象接口（concept 或纯虚基类）定义，运行时通过依赖注入解耦

✅ 性能敏感场景的硬性约束

• GPU 内核函数中禁用动态内存分配、异常、虚函数调用、STL 容器
• 数据结构强制按 SIMD 对齐（如 alignas(32)），避免跨缓存行访问
• 多线程共享状态优先使用 std::atomic + 无锁结构，而非 std::mutex（除非持有时间

它如何真正落地？——不是贴在墙上的文档

• CI/CD 强制门禁：Clang Static Analyzer 检查静态内存分配超限（≤4KB/翻译单元）、Cppcheck 控制圈复杂度（≤10）
• 编译器属性驱动优化：[[nodiscard]]、[[likely]]、__restrict__ 成为接口契约一部分
• 错误即规范：std::expected 的 value() 调用若未检查 has_value()，静态分析直接报错（非警告）
• 模块构建标准化：clang++ -std=c++23 -fmodules-ts 已成企业级构建流水线标配

这些准则背后没有玄学，只有对硬件真实限制的尊重、对编译器优化能力的信任、以及对团队协作成本的清醒认知。写得“少”，不等于写得“快”；写得“显”，才真正写得“稳”。