C++编程规范之0:不要拘泥于小节

简介:

不拘泥于小节又名了解那些东西不应该标准化

原则:只规定需要规定的事情,不要强制施加个人洗好或者过时的做法

应该在每个源文件乃至每个项目中都使用一致的格式,因为同一段代码中要在集中编程风格直接换来换去是很不舒服的。但是无需在多个项目或者整个公司范围内强制实施一致的格式。几种常见的情况如:

  • 不要规定缩进多少,应该规定要用缩进来体现代码的结构。

    缩进空格的数量可以遵照个人习惯,但是至少在每个文件中应该保持一致。

  • 不要强制行的具体长度,应该保证代码行的长度有利于阅读

    可以遵照个人习惯来决定行长,但是不要过长。研究表明,文字长度不超过10个单词最有利于阅读。

  • 不要在命名方面规定过多,应该规定的是使用一致的命名规范

    有两点是必须的:(1)永远不要使用“晦涩的名称”,即以下划线开始或者包含双下划线的名称;(2)总是使用形如ONLY_UPPERCASE-NAMES的全大写字母表示宏,不要考虑使用常见的词或者缩略词作为宏的名称。

  • 不要规定注释风格(除非需要使用工具从特定的体例中提取出文档)
    应该编写有用的注释,尽可能编写代码而不是写注释,不要在注释中出现重复写代码语义,这样很容易产生不一致。应该编写的是解释方法和原理的说明性注释。

 

相关文章
|
1月前
|
自然语言处理 算法 Java
C/C++ 程序员编程规范之注释
C/C++ 程序员编程规范之注释
61 1
|
1月前
|
存储 算法 测试技术
|
1月前
|
程序员 编译器 C++
|
1月前
|
程序员 开发工具 C++
C/C++ 程序员编程规范之排版
C/C++ 程序员编程规范之排版
43 1
|
11月前
|
存储 设计模式 算法
03-📝C++核心语法|面向对象1【 C++编程规范、类和对象、面向对象程序设计案例、对象的构造和析构、C++面向对象模型初探】
复习`C++核心语法`,且适当进行汇编探索底层实现原理,进一步夯实基础,为以后的`底层开发`、`音视频开发`、`跨平台开发`、`算法`等方向的进一步学习埋下伏笔。
03-📝C++核心语法|面向对象1【 C++编程规范、类和对象、面向对象程序设计案例、对象的构造和析构、C++面向对象模型初探】
|
10月前
|
编译器 C++
【C++】实用编程规范与建议
C++ 相关,比较实用的 防止疏漏出错的编码规范与编码建议
128 0
|
程序员 C++ C语言
《C++编程规范:101条规则、准则与最佳实践》——导读
许多糟糕的编程规范都是由一些没有很好地理解语言、没有很好地理解软件开发或者试图标准化过多东西的人制定的。糟糕的编程规范会很快丧失可信度,如果程序员不喜欢或者不同意其中一些糟糕的准则,那么即使规范中有一些合理的准则,也可能被不抱幻想的程序员所忽略,这还是最好的情况,最坏的情况下,糟糕的标准可能真会被强
1808 0