嵌入式软件编程规范[52页].docVIP

个人收集整理 勿做商业用途 PAGE2 / NUMPAGES2 作者：ZHANGJIAN 仅供个人学习，勿做商业用途 TRZN 嵌入式软件编程规范 文档修改历史： 版本号 日期 修改者及常用邮箱 修改日志 0.1 2016-10-28 杨科 ykee126@126.com 根据查阅的相关资料整理，此版本为第一次提交。  TOC \o 1-3 \h \z \u 1 文档概述 h 4文档来自于网络搜索 1.1 关于本文档 h 4文档来自于网络搜索 1.2 参考文献 h 4文档来自于网络搜索 2 排版 h 5文档来自于网络搜索 3 注释 h 10文档来自于网络搜索 4 标识符命名 h 19文档来自于网络搜索 5 可读性 h 25文档来自于网络搜索 6 变量、结构 h 26文档来自于网络搜索 7 宏 h 31文档来自于网络搜索 8 函数、过程 h 33文档来自于网络搜索 9 可测性 h 41文档来自于网络搜索 10 代码版本管理 h 44文档来自于网络搜索 10.1 代码质量定义 h 44文档来自于网络搜索 10.2 Git分支定义 h 44文档来自于网络搜索 10.3 Git代码引入规定 h 44文档来自于网络搜索 10.4 Git代码Commit顺序 h 45文档来自于网络搜索 10.5 Commit文件过程中的其他注意事项 h 45文档来自于网络搜索 11 附录A – 推荐编辑器的默认配置修改 h 46文档来自于网络搜索 11.1 Keil uVision5默认配置修改 h 46文档来自于网络搜索  文档概述 关于本文档 本文档规范了芜湖天人智能有限公司嵌入式软件部软件代码的书写规范和原则。 本文档仅供公司内部员工使用。 公司机密，严禁外传。 本文档中各规则的格式如下： 【规则 编号】 [规则内容] [[标记]] 其中[标记]的含义如下： （必须） ： 表示该条规则是必须遵守的。 （建议） ： 表示该条规则是建议遵守的。 （可选）或没有标记 ： 表示该条规则是可选择遵守的。 本文档的示例中，如有使用“//”，并非代码注释，而是文档的注释(有可能是文档中对代码注释的解释)。 参考文献 [1]高质量C++编程 [2]Effective C++ [3]More Effective C++ [4]C++ Primer [5]Thinking in C++  排版 【规则 STYLEREF 1 \s 2 SEQ 规则 \* ARABIC \s 1 1】程序块要采用缩进风格编写，缩进的空格数为4个,对齐使用空格键，不得使用TAB键。[必须]文档来自于网络搜索 嵌入式软件开发的代码编辑器，推荐使用Keil uVision5，编辑器参数设置见附录A。 【规则 STYLEREF 1 \s 2 SEQ 规则 \* ARABIC \s 1 2】相对独立的程序块之间、变量说明之后必须加空行。[必须]文档来自于网络搜索 示例： 不正确的书写方式： if (!rpr_valid_ni(ni)) { ... // program code } gRprRepssnInd = gRprSsnData[idx].repssn_index; gRprRepssnNi = gRprSsnData[idx].ni; 正确的书写方式: if (!rpr_valid_ni(ni)) { ... // program code } //空行 gRprRepssnInd = gRprSsnData[idx].repssn_index; gRprRepssnNi = gRprSsnData[idx].ni; 【规则 STYLEREF 1 \s 2 SEQ 规则 \* ARABIC \s 1 3】较长的语句（80字符）要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读。[必须]文档来自于网络搜索 示例： gRprPermCountMsg.head.len = RPR_NO7_TO_STAT_PERM_COUNT_LEN + RPR_STAT_SIZE_PER_FRAM * sizeof(