C++编程风格指南（短小精悍，适合新手）

在线阅读

• 点击阅读在线文档

这本风格指南翻译自C++ Programming Style Guidelines，短小精悍，我觉得非常适合C++新手。
最近刚翻译完这份文档，为了方便手机阅读，又仿照Google 开源项目风格指南的形式，把翻译好的内容托管在了read the docs，效果看起来还可以。注意：每条建议都是表格的形式，太长的可以左右滑动。

下载

完整翻译有Markdown版本和导出的PDF版本，可以从GitHub主页下载：

• 点击访问GitHub主页

推荐这份指南的原因

虽然关于代码风格的书或在线文档有很多，已经出版的书例如《重构-改善既有代码的设计》、《代码整洁之道》；很多大公司也有自己的编程规范，例如：Google 开源项目风格指南 (中文版)。虽然这些资料的内容都很详细、很权威，但不得不承认实在是太长了。。。Google编程规范中文版有5万字，当初刚学习C++的我看的一脸懵逼，而且不仅很长，很多规范其实在个人编程的时候基本用不上，所以不知道从哪里下手。

我接触到这份指南是在刚开始学习C++的时候，由MOOC公开课——北京邮电大学《C++程序设计（面向对象进阶）》的老师推荐的。之所以说这份指南适合初学者，主要有以下原因：

1. 字数少：翻译之后不到8000字。
2. 格式友好，方便阅读：这里面其实是一条一条的建议，只有90条左右；每条建议还给出了示例和之所以这样做的原因（这一点对于记忆很有用！）；另外格式很清晰，方便多次回看。
3. 内容很基础，初学者也能用得到：学习编程规范的最好方法就是边学边用，但是像Google编程规范中的很多内容，初学者的日常编程其实是用不到的，而这份规范中的大部分内容都很基础，也很常用；又因为它很短，用到的时候可以很快翻到相应的地方，不至于太影响编程体验。
4. 有利于培养代码规范的意识：正如作者前两条建议所说——“只要能够提升可读性，允许采用不同于该指南的做法。” “如果你个人很抵触该指南的某项建议，可以不采纳。”作者一直在强调，重要的是这种下意识为阅读代码的人着想的意识，而不是某种固定、死板的做法，这一点让我受益很多。

总之，这篇指南适合以下读者：

• 从一开始就想养成良好编程习惯的C++初学者

  对你来说，这份短小精悍的指南将是一个非常好的选择。

• 想要从现在开始纠正之前的编程习惯的C++使用者

  相信会有很多人像我一样，因为畏惧Google编程规范之类文档的过于庞杂而不知道从何处开始，这份指南同样适合你们。万事开头难，你完全可以把阅读这份指南当做一个相对轻松的开头，等到培养一定的习惯之后再考虑学习那些更加复杂、也更加完善的编程指南。

欢迎star和建议

因为水平不够，英文原文中一些单词不太确定含义，已在译文中下划线标出。如果合适的译法，欢迎在这篇博客下面评论或直接issue，我们一起完善这份文档。