入行这么多年,我见过太多因为代码风格问题吵起来的场景。有人坚持 Allman 风格,有人死守 K&R,有人变量名全小写下划线,有人非要首字母大写。C++ 这门语言本身就带着多范式基因,从 C 风格的过程式写法到模板元编程,从裸指针到智能指针,同一份代码里可以同时出现完全不同的气质。这种自由度在写小工具时是爽快,一旦项目规模上来,就成了灾难。lil_tea 这份 C++ 风格指南,最初就是为解决这类问题而整理的。
这个标题乍看像个个人项目,但它背后折射出的需求是普遍的:每个 C++ 开发者在某个阶段都需要一份属于自己的、或者属于团队的编码规范。不管是刚从 C 转过来的老手,还是刚刚啃完语法书的新人,都会在"到底该怎么写才像样"这个问题上卡住。这份指南要解决的,就是这个"像样"的问题——让代码不仅跑得对,还读得懂、改得动、review 得顺。下面我会从为什么需要风格指南、核心决策点、实操落地、以及踩坑记录四个维度,把这份指南拆开揉碎讲清楚。
1. 为什么 C++ 比其他语言更需要一份风格指南
很多语言有官方风格,比如 Go 有 gofmt、Python 有 PEP 8、Rust 有 rustfmt,语言层面就给你定死了,就算你不想遵守,工具也会强制你执行。但 C++ 没有。标准委员会不关心你变量名用驼峰还是下划线,编译器也照单全收,不报一个 warning。这就导致每个 C++ 项目都可以是一套全新的风格,而且每套风格的支持者都觉得自己那套才是正统。
1.1 C++ 多范式特性带来的风格分裂
C++ 支持过程式、面向对象、泛型、函数式四种主要范式,这四种范式天然会诱导出不同风格的代码。写惯 C 的人倾向于把变量声明在函数开头,用裸指针传参,习惯用 struct 聚合数据;写惯 Java 的人一上来就是 class 套 interface,getter/setter 铺满整个文件;玩模板的人则满屏都是 typename 和 constexpr。这些写法单独看都没问题,但如果混在同一个项目里,阅读体验会非常割裂。
我见过一个真实的例子:同一个函数里,前半段用 int* p = new int(5);,后半段突然冒出一个 std::unique_ptr<int> q = std::make_unique<int>(5);,然后两个指针都被当参数传给一个函数,函数内部不知道是该 delete 还是不该 delete。这种代码跑起来可能没问题,但它把心智负担全甩给了后来维护的人。风格指南在这里要做的第一件事,就是统一资源管理策略和指针使用方式,把这类隐含的歧义从源头上消灭掉。
1.2 风格指南不是限制,是降低认知负担的手段
很多初学者抵触风格指南,觉得"我代码能跑就行了,管那么多干嘛"。这个想法在写作业时成立,在企业项目里不成立。企业代码的平均寿命是 5 到 10 年,写代码的人一两年就换一茬。如果每份代码风格都不同,后来者每看一个新文件就要重新适应一种风格,这会严重拖慢开发效率。风格指南的本质不是限制你的表达自由,而是把风格问题变成无需思考的默认选项,让你把有限的脑力放在真正的逻辑难点上。
所以 lil_tea 这份指南的第一条原则就是:风格一致性优先于个人偏好。哪怕你个人更喜欢另一种写法,只要团队定了规则,就按规则来。这跟交通规则一个道理——靠右行驶未必比靠左行驶更科学,但所有车都靠右行驶一定比一半靠右一半靠左安全得多。
1.3 一套好的风格指南应该覆盖哪些范围
要明确一点:风格指南不是 C++ 语法教程,它不需要教人怎么写循环、怎么用 vector。它应该聚焦在那些有争议、有选择空间的地方。我整理了几类必覆盖的内容:
- 命名规范:类型、函数、变量、常量、宏、文件名的命名规则。
- 格式排版:缩进、括号、行宽、空行、头文件顺序。
- 注释规范:什么时候该写注释、什么时候不该写、注释怎么写。
- 现代 C++ 实践:智能指针 vs 裸指针、auto 的使用策略、const 正确性、异常处理。
- 工程实践:头文件组织、include 顺序、命名空间使用、API 设计约定。
下文会逐一展开讲。需要提醒的是,风格指南应该给"默认答案",而不是给"唯一答案"。比如"行宽不超过 80 列"可以作为默认值,但必要时允许例外。指南最好包含例外条款,否则执行时会很痛苦。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 写好一份风格指南的核心决策点
这一节是整份指南的灵魂。我在整理 lil_tea 风格指南时,反复权衡过很多细节,有些看起来微不足道,实际上影响深远。下面挑几个最关键的说。
2.1 命名规范:驼峰还是下划线
命名是最容易引发争论的话题。C++ 标准库用 snake_case,STL 用 snake_case;Google C++ Style Guide 用 snake_case 函数 + PascalCase 类型;很多游戏公司用 camelCase 函数。到底选哪套?我的建议很直接:跟标准库保持一致。
原因有三:第一,标准库是所有 C++ 开发者共同的语言基础,用 snake_case 能最大程度降低学习成本;第二,你可以把 STL 源码当范文看,风格统一方便吸收经验;第三,现代 C++ 比较流行 snake_case 全小写,代码紧凑,不易与其他语言混淆。
具体规则我建议这样定:
| 类别 | 规则 | 示例 |
|---|---|---|
| 类型名(class/struct/enum) | PascalCase | HttpClient、CompressionMode |
| 函数名 | snake_case | parse_request()、get_user_info() |
| 变量名 |
