C++ Core Guidelines由Bjarne Stroustrup和Herb Sutter等制定，旨在提升代码安全、效率与可维护性；其核心是通过类型安全、RAII资源管理、边界检查、函数简洁设计等原则避免常见错误；推荐使用智能指针、gsl::span、enum class等现代C++特性，并结合clang-tidy等工具在CI中持续检测违规；团队应从新模块逐步引入，建立规范并加强审查，推动代码质量提升。
C++ Core Guidelines 是由 Bjarne Stroustrup（C++ 之父）和 Herb Sutter 等专家共同制定的一套现代化 C++ 编程最佳实践。它旨在帮助开发者编写更安全、高效、可维护的 C++ 代码。这些指南覆盖了类型安全、资源管理、函数设计、类接口、并发等多个方面，是现代 C++ 开发的重要参考。
理解 C++ Core Guidelines 的核心目标
这些指南的核心不是强制规范语法，而是引导开发者避免常见陷阱，提升代码质量。重点包括：
- 类型安全：尽可能使用强类型，避免隐式转换和裸指针操作。
- 资源管理：优先使用 RAII 和智能指针（如 std::unique_ptr、std::shared_ptr），避免手动 new/delete。
- 边界检查：避免数组越界，推荐使用 std::array、std::vector 而非原生数组。
- 函数设计：函数应简洁、单一职责，参数尽量使用 const 引用或值传递，避免输出参数。
- 避免宏和全局状态：减少副作用，提高可测试性。
在项目中实际应用指南的关键点
要真正发挥这些指导原则的作用，需要结合工具和编码习惯：
Outlook Calendar & Microsoft 365
下载
Outlook 日历 / Microsoft 365 日历 SECURE API CLI。当用户需要列出、搜索或读取 Outlook / Microsoft 365 日历事件，以及创建……
- 启用静态分析工具：使用 Microsoft GSL（Guidelines Support Library）配合编译器警告，或集成 clang-tidy，它可以自动检测违反 Core Guidelines 的代码模式。
-
使用 gsl::span 替代数组指针：例如，函数接收缓冲区时，用 gsl::span
比 int* 更安全，自带长度信息。 - 优先返回值而非输出参数：现代编译器对返回值有优化（RVO/NRVO），代码也更清晰。比如返回 std::vector 而不是传入 vector& 作为输出。
- 用 enum class 代替传统枚举：防止命名污染和隐式转换，增强类型安全性。
- 避免裸 new 和 delete：所有动态对象都应由智能指针或容器管理。
如何开始使用并持续遵循这些原则
不必一次性全面实施，可以从关键部分逐步引入：
立即学习“C++免费学习笔记（深入）”；
- 从新模块开始采用 Core Guidelines 风格。
- 在 CI 流程中加入 clang-tidy 并启用 -checks=cppcoreguidelines-* 检查项。
- 团队内部建立编码规范文档，引用具体规则如 F.15（不要使用 varargs 函数） 或 R.1（资源获取即初始化）。
- 定期进行代码审查，重点关注资源泄漏、原始指针使用和接口设计。
基本上就这些。C++ Core Guidelines 不是一套死板的教条，而是一种思维方式的转变——写更清晰、更少出错的代码。配合现代 C++ 特性（C++17/20/23）和工具链支持，能显著提升项目的长期可维护性。
