• 编程规范
    • 目的
    • 重点关注
    • 约定
    • 例外

    编程规范

    目的

    规则并不是完美的,通过禁止在特定情况下有用的特性,可能会对代码实现造成影响。但是我们制定规则的目的“为了大多数程序员可以得到更多的好处”, 如果在团队运作中认为某个规则无法遵循,希望可以共同改进该规则。

    参考该规范之前,希望您具有相应的C++基础能力,而不是通过该文档来学习C++。

    • 了解C++的ISO标准;
    • 熟知C++的基本语言特性,包括C++ 03/11/14/17相关特性;
    • 了解C++的标准库;

    重点关注

    • 约定C++的编程风格,比如命名,排版等。
    • C++的模块化设计,如何设计头文件,类,接口和函数。
    • C++相关特性的优秀实践,比如常量,类型转换,资源管理,模板等。
    • 现代C++的优秀实践,包括C++11/14/17中可以提高代码可维护性,提高代码可靠性的相关约定。

    约定

    规则:编程时必须遵守的约定(must)

    建议:编程时应该遵守的约定(should)

    本规范适用通用C++标准, 如果没有特定的标准版本,适用所有的版本(C++03/11/14/17)。

    例外

    无论是'规则'还是'建议',都必须理解该条目这么规定的原因,并努力遵守。但是,有些规则和建议可能会有例外。

    在不违背总体原则,经过充分考虑,有充足的理由的前提下,可以适当违背规范中约定。例外破坏了代码的一致性,请尽量避免。'规则'的例外应该是极少的。

    下列情况,应风格一致性原则优先:修改外部开源代码、第三方代码时,应该遵守开源代码、第三方代码已有规范,保持风格统一。**某些特定领域,优先参考其行业规范。**