C编程规范1推荐.doc

C/C++ 编程规范 Version 1.0 目 录 第一章 概述 ------------------------------------------------------------ 1 第二章 代码排版 ------------------------------------------------------------------------------------- 2 第三章 程序注释 ------------------------------------------------------------------------------------- 8 第四章 标识符命名 ---------------------------------------------------------------------------------- 17 第五章 可读性 ---------------------------------------------------------------------------------------- 21 第六章 变量结构 ------------------------------------------------------------------------------------- 24 第七章 函数过程 ------------------------------------------------------------------------------------- 32 第八章 可测性 ---------------------------------------------------------------------------------------- 42 第九章 程序效率 ------------------------------------------------------------------------------------- 48 第十章 质量保证 ------------------------------------------------------------------------------------- 53 第十一章 代码编辑,编译,审查 -------------------------------------------------------------------- 61 第十二章 代码测试及维护 ------------------------------------------------------------------------- 63 第十三章 宏 ------------------------------------------------------------------------------------------- 64 附录一: 匈牙利命名法 ----------------------------------------------------------------------------- 66 第一章 概 述 1.1 规范制定原则 程序员花更多的时间在调试、维护和升级已有代码上，而不是编写新的代码； 最重要的是正确性，其次是可维护性，最后才是效率； 学习如何写优美的程序与学习如何正确地编写代码同样重要； 让程序尽量简单易懂，即使违背了某些规则也无关紧要； 一个运行正常但没有注释的程序如同一个等待爆炸的定时炸弹，因为早晚会有人修改或升级这个程序； 好风格应该成为一种习惯。如果你在开始写代码时就关心风格问题，如果你花时间去审视和改进它，你将会逐渐养成一种好的编程习惯。一旦这种习惯变成自动的东西，你的潜意识就会帮你照料许多细节问题，甚至你在工作压力下写出的代码也会更好。 术语定义 Pascal 大小写 将标识符的首字母和后面连接的每个单词的首字母都大写。可以对三字符或更多字符的标识符使用Pascal 大小写。例如： BackColor 所有2个字母变量首个字母要求大写,小于两个字母的均使用大写 1.1.2 Camel 大小写 标识符的首字母小写，而每个后面连接的单词的首字母都大写。例如： backColor 首个字符小写 1.3 文件命名组织 1.3.1 文件命名 文件名遵从Pascal命名法，无特殊情况，扩展名小写。 使用统一而又通用的文件扩展名： C类:.c, C++类: cpp. 1.3.2 项目 1. .一个产品建立一个工程项目管理文件 2. 项目内文件包括源文件、头文件、版本说明文件以及其它说明文件 第二章 代码外观 2.1 列宽 一行