version: "1.0.0" name: std-cpp description: 提供 C++ 编码规范（基于 Google C++ Style Guide）。当编写或 review C++ 代码（.cc/.cpp/.h 文件）时使用。
C++ 编码规范
基于 Google C++ Style Guide，使用 C++17。
核心规则速查
| 类别 | 必须遵守 | |
|---|
| 版本 | C++17，不用 C++2a 功能 | |
| 头文件 | self-contained，#pragma once，include 顺序规范 | |
| 命名空间 | 必须使用，禁止头文件全局 using | |
| 类 | 构造函数禁止调用虚函数，单参数构造函数加 explicit | |
| 命名 | 类型 PascalCase，变量 snake_case，常量 kCamelCase | |
| 转换 | 使用 C++ 风格（static_cast 等），禁止 C 风格 | |
| 自增 | 迭代器用前置 ++i | |
完整规范
详见 reference/full-standards.md，包含：
- 规范等级定义（必须/推荐/可选）
- 头文件、作用域、类、函数规范
- 命名、注释、格式规范