## 软件开发规范与技巧
### 排版
1.1 长语句要分成多行书写，操作符放在新行之首，新行要适当缩进。
1.2 程序块采用缩进风格编写，缩进空格数为4个。
1.3 相对独立的程序块之间、变量说明之后必须加空行。
1.4 若函数或过程中的参数较长，则要进行适当的划分。
1.5 避免在条件表达式内调用方法。
1.6 避免使用foreach循环不可变量类型集合，如字符串数组。
1.7 只对具有并行条件逻辑的简单操作使用switch/case语句。
1.8 对于短条件序列和复杂条件，优先使用嵌套if/else语句，而不是switch/case。
1.9 函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格。
1.10 分界符（如大括号）应各独占一行并且位于同一列，同时与引用它们的语句左对齐。
1.11 关键字、变量、常量进行对等操作时，它们之间的操作符前后要加空格；进行非对等操作时，立即操作符后不应加空格。
1.12 循环、判断等语句中若有较长的表达式，则要进行适应的划分。
1.13 不允许把多个短语句写在一行中，即一行只写一条语句。
1.14 if、while、for、default、do等语句自占一行。
### 注释
2.1 一般情况下，源程序有效注释量必须在20％以上。
2.2 源文件头部应进行注释，列出：版权说明、版本号、生成日期、作者、模块目的/功能等。
2.3 HTML等格式的网页文件头部应使用“<%-- /* …… */ --%>”进行注释，列出：版权说明、版本号、生成日期、主要函数和网页的功能、修改日志等。
2.4 函数头部应进行注释，列出：函数的目的/功能、输入参数、输出参数、返回值等。
2.5 边写代码边注释，修改代码同时修改相应的注释，以保证注释与代码的一致性。
2.6 注释的内容要清楚、明了，含义准确。
2.7 避免在注释中使用缩写。
2.8 注释应与其描述的代码相近，对代码的注释应放在其上方或右方，不可放在下面。
2.9 数据结构声明，如果不是充分自注释的，必须加以注释。
2.10 全局变量要有较详细的注释。
2.11 注释与所描述内容进行同样的缩排。
2.12 对变量的定义和分支语句（条件分支、循环语句等）必须编写注释。
2.13 对于switch语句下的case语句，如果有特殊情况需要处理完一个case后进入下一个case处理，必须在该case语句处理完、下一个case语句前加上明确的注释。
### 标识符命名
3.1 标识符的命名要清晰、明了，有明确含义，使用完整单词或基本可以理解的缩写。
3.2 不要用汉语拼音做标识符的命名，可以用单词工具中的单词做为命名标准。
3.3 如果使用特殊约定或缩写，则要有注释说明。
3.4 全局
资源下载
加入本站QQ群获取更多实时游戏软件,线报,资源,福利点我加群
免责声明：
多特下载站仅为用户提供信息存储空间服务，所有资源均来源于网络或用户上传。我们无法对所有内容进行逐一审核，因此不保证资源的绝对准确性和完整性。用户在使用过程中应自行判断并承担相关风险。如涉及版权问题，请及时联系我们处理。对于因使用本站资源引发的一切争议、损失或法律责任，除法律明确规定外，多特下载站概不负责。请用户务必遵守法律法规，合理合法使用下载内容。侵删请致信E-mail： caozl@nbrjwl.com
同类推荐
