1. 命名规范:拒绝拼音与神秘缩写

类与结构体采用大驼峰,如

函数与变量用小驼峰,禁止或这类命名

宏和常量全大写加下划线,例如

成员变量推荐加前缀或尾部下划线,如或

2. 格式与注释:机器能检查的绝不靠自觉

统一换行与缩进:用ClangFormat配置团队规范,比如指针符号靠左

括号风格:Google风格要求函数左括号不换行,类定义左括号换行

注释三重境界:

3. 内存管理:从裸指针到智能指针的进化

现代C++项目应该彻底告别:

注意:循环引用场景用打破闭环,容器存储对象优先用替代减少拷贝。

4. 静态检查:把BUG扼杀在编译期

编译器配置:开启把警告当错误处理

Clang-Tidy配置示例:

自定义检查规则:禁止使用atoi(改用stoi)、强制override关键字、检测未初始化变量

5. 单元测试:不只是QA的事情

Google Test实战示例:

建议对核心模块保持90%+行覆盖,边界测试要包含异常数据(如空指针、超大数值、特殊字符)。

6. 持续集成:规范执行的守护者

GitHub Actions配置片段:

关键质量门禁:静态检查零警告、单元测试全通过、代码覆盖率不降级、Sanitizer检测无内存错误。

(结尾实践建议)

刚开始推行规范时总有程序员抱怨束缚创意,但经历过三次凌晨两点排查指针越界问题后,团队都会真香定律。建议从新项目开始严格执行,老项目增量改造,最终让规范成为肌肉记忆。记住:优秀的代码不是写出来的,是管出来的。

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐