C++ 编程规范

目录

• C++ 编程规范
  • 编程规范与人的关系
    • 改善代码质量
    • 提升开发速度
    • 增进团队精神
    • 在正确的方向删取得一致
  • 第0条：不要拘泥于小节
    • 只规定须要规定的事情
    • 在每一个源文件和项目中使用一致的格式
    • 不要规定缩进多少
    • 不要在命名方面规定过多
    • 不要规定注释体例

C++ 编程规范

这是一本 由两位世界顶级专家联袂巨献，适合全部层次 C++程序员 的 C++ 界20年集大成之做，这里有 101 条关于 C++ 编程的规则、总则与最佳实践。

编程规范与人的关系

好的编程规范可以带来下列许多相互关联的优势：

改善代码质量

鼓励开发人员一向地正确行事，从而可以直接提升软件的质量和可维护性。

提升开发速度

开发人员不须要老是从一些基本原则出发进行决策。

增进团队精神

有助于减小在一些小事上没必要要的争论，使团队成员更容易阅读和维护其余成员的代码。

在正确的方向删取得一致

使开发人员放开手脚，在有意义的方向上发挥创造性。

第0条：不要拘泥于小节

（又名：了解哪些东西不该该标准化）

只规定须要规定的事情

• 不要强制施加我的喜爱或者过期的作法:

  有些问题只是我的喜爱，并不影响程序的正确性或可读性，因此这些问题不该该出如今编程规范中，任何专业程序员均可以很容易地阅读和编写与其习惯的格式略有不一样的代码。

在每一个源文件和项目中使用一致的格式

• 同一段代码中要在几种编程风格(style)之间换来换去是很不舒服的。
• 可是无需再多个项目或者整个公司范围内强制实施一致的格式。

这里咱们列举几种常见的状况，重要的不是设定规则，而是与所维护的文件中已使用的体例保持一致：

不要规定缩进多少

• 应该规定要用缩进来体现代码的结构；
• 缩进空格的数量能够遵守我的习惯；

• 可是至少在每一个文件中保持一致。

  不要强制行的具体长度

• 应该保证代码行的长度有利于阅读；
• 能够遵守我的习惯来决定行长，可是不要过长；

• 研究代表，文章长度不超过10个单词最利于阅读。

不要在命名方面规定过多

应该规定的是使用一致的命名规范：只有两点是必需的：

• 1.不要使用晦涩的名称
  即如下划线开始或者包含双下划线的名称

• 2.老是使用形如 ONLY_UPPERCASE_NAMES 的 全大写字母表示宏 ，

  • 不要考虑使用常见的词或者缩略语做为宏的名称（包括常见的模板参数，好比T和U，#define T anything 这样的代码是极容易混淆的）；

  • 另外，应该使用一致的、有意义的名称，遵循文件的或者模块的规范，若是你没法决定本身的命名规范，能够尝试以下的命名规范：

    • 类、函数和枚举的名称形如LikeThis,即单词首字母大写；
    • 变量形如likeThis_;
    • 宏名形如LIKE_THIS。

不要规定注释体例

• 除非须要使用工具从特定的体例中提取出文档；
• 应该编写有用的注释；
• 尽量编写代码而不是注释；
• 不要在注释中重复学代码语义，这样很容易产生不一致；

• 应该编写的是解释方法和原理的说明性注释。

  不要尝试实施陈旧的规则

• 即便他们曾经子一些比较陈旧的编程规范中出现过。