26,395
次編輯
變更
编码规则
,無編輯摘要
{| class="wikitable" align="right"
|-
| style="background: #66CCFFFF2400" align= center| '''<big>编码规则</big>'''|-|<center><img src=https://gimg2.baidu.com/image_search/src=http%3A%2F%2Ftxt6.book118.com%2F2017%2F0101%2Fbook78606%2F78605137.png&refer=http%3A%2F%2Ftxt6.book118.com&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=auto?sec=1661984093&t=11605bb0e0f540bcb96c2645394f5b7a width="300"></center><small>[https://image.baidu.com/search/index?ct=201326592&tn=baiduimage&word=%E7%BC%96%E7%A0%81%E8%A7%84%E5%88%99&pn=17&spn=0&ie=utf-8&oe=utf-8&cl=2&lm=-1&fr=&se=&sme=&cs=1008631%2C903197775&os=3134626658%2C398652099&objurl=https%3A%2F%2Fgimg2.baidu.com%2Fimage_search%2Fsrc%3Dhttp%3A%2F%2Ftxt6.book118.com%2F2017%2F0101%2Fbook78606%2F78605137.png%26refer%3Dhttp%3A%2F%2Ftxt6.book118.com%26app%3D2002%26size%3Df9999%2C10000%26q%3Da80%26n%3D0%26g%3D0n%26fmt%3Dauto%3Fsec%3D1661984093%26t%3D11605bb0e0f540bcb96c2645394f5b7a&di=7108135681917976577&tt=1&is=0%2C0&adpicid=0&gsm=78&dyTabStr=MCwzLDIsNCwxLDYsNSw3LDgsOQ%3D%3D 来自 呢图网 的图片]</small>|-| style="background: #FF2400" align= center| '''<big></big> '''
|-
|[[File:align= light| 缩略图|居中|[ 原图链接]]]
命名;使用匈牙利表示法
|}
'''编码规则'''是程序编码所要遵循的规则,要注意代码的正确性、稳定性、可读性。要避免使用不易理解的 [[ 数字 ]] ,用有意义的标识来替代,不要使用难懂的技巧性很高的语句。源程序中关系较为紧密的代码应尽可能相邻。<ref>[ https://max.book118.com/html/2019/0210/5120223314002010.shtm 编码规则(标准)], 360搜索 , --2019年2月10日</ref>
==排版==
1.关键词和操作符之间加适当的 [[ 空格 ]] 。
2.相对独立的程序块与块之间加空行
3.较长的语句、表达式等要分成多行书写。
4.划分出的新行要进行适应的缩进,使排版整齐,语句可读。
5.长表达式要在低优先级操作符处划分新行,操作符放在新行之首。
6.循环、判断等语句中若有较长的 [[ 表达 ]] 式或语句,则要进行适应的划分。
7.若函数或过程中的参数较长,则要进行适当的划分。
8.不允许把多个短语句写在一行中,即一行只写一条语句。
9.函数或过程的开始、结构的定义及 [[ 循环 ]] 、判断等语句中的代码都要采用缩进风格。
10.C/C++语言是用大括号‘{ ’和‘ }’界定一段程序块的,编写程序块时‘{ ’和 ‘ }’应各独占一行并且位于同一列,同时与引用它们的语句左对齐。在函数体 的开始、类的定义、结构的定义、枚举的定义以及if、for、do、while、 switch、case语句中的程序都要采用如上的缩进方式。
==注释==
1.注释要简单明了。
2.边写代码边注释,修改代码同时修改相应的 [[ 注释 ]] ,以保证注释与代码的一致性。
3.在必要的地方注释,注释量要适中。注释的内容要清楚、明了,含义准确,防止 注释二义性。保持注释与其描述的代码相邻,即注释的就近原则。
4.对代码的注释应放在其上方相邻位置,不可放在下面。
6.变量、常量的注释应放在其上方相邻位置或右方。
7.全局变量要有较详细的注释,包括对其功能、取值范围、哪些函数或过程存取它以及存取时注意事项等的说明。
8.在每个源文件的头部要有必要的注释信息,包括: [[ 文件 ]] 名;版本号;作者;生成日期;模块功能描述(如功能、主要算法、内部各部分之间的关系、该文件与其它文件关系等);主要函数或过程清单及本文件历史修改记录等。
9.在每个函数或过程的前面要有必要的注释信息,包括:函数或过程名称;功能描 述;输入、输出及返回值说明;调用关系及被调用关系说明等。
==命名==
1.避免使用不易理解的数字,用有意义的标识来替代。
2.不要使用难懂的技巧性很高的语句。
3.源 [[ 程序 ]] 中关系较为紧密的代码应尽可能相邻。
==变量==
1.去掉没必要的公共变量。
2.构造仅有一个模块或函数可以修改、创建,而其余有关模块或函数只访问的公共变量,防止多个不同模块或 [[ 函数 ]] 都可以修改、创建同一公共变量的现象。
3.仔细定义并明确公共变量的含义、作用、取值范围及公共变量间的关系。
4.明确公共变量与操作此公共变量的函数或过程的关系,如访问、修改及创建等。
5.当向公共变量传递数据时,要十分小心,防止赋与不合理的值或越界等现象发生。
6.防止局部变量与公共变量同名。
7.仔细设计结构中元素的布局与排列顺序,使结构容易 [[ 理解 ]] 、节省占用空间,并减少引起误用现象。
8.结构的设计要尽量考虑向前兼容和以后的版本升级,并为某些未来可能的应用保留余地(如预留一些空间等)。
9.留心具体语言及编译器处理不同数据类型的原则及有关细节。
5.尽量不要编写依赖于其他函数内部实现的函数。
6.避免设计多参数函数,不使用的参数从接口中去掉。
7.用注释详细 [[ 说明 ]] 每个参数的作用、取值范围及参数间的关系。
8.检查函数所有参数输入的有效性。
9.检查函数所有非参数输入的有效性,如数据文件、公共变量等。
15.编写可重入函数时,若使用全局变量,则应通过关中断、信号量(即P、V操作)等手段对其加以保护。
==可测性==
1.在编写代码之前,应预先设计好 [[ 程序 ]] 调试与测试的方法和手段,并设计好各种调测开关及相应测试代码如打印函数等。
2.在进行集成测试/系统联调之前,要构造好测试环境、测试项目及测试用例,同时仔细分析并优化测试用例,以提高测试效率。
==程序效率==
4.编程时,要随时留心代码效率;优化代码时,要考虑周全。
5.要仔细地构造或直接用汇编编写调用频繁或性能要求极高的函数。
6.通过对系统数据结构划分与组织的改进,以及对 [[ 程序 ]] 算法的优化来提高空间效率。
7.在多重循环中,应将最忙的循环放在最内层。
8.尽量减少循环嵌套层次。
(2)稳定性、安全性,指程序稳定、可靠、安全。
(3)可测试性,指程序要具有良好的可测试性。
(4)规范/可读性,指程序书写 [[ 风格 ]] 、命名规则等要符合规范。
(5)全局效率,指软件系统的整体效率。
(6)局部效率,指某个模块/子模块/函数的本身效率。
7.时刻注意表达式是否会上溢、下溢。
8.认真处理程序所能遇到的各种出错情况。
9.系统运行之初,要初始化有关变量及运行 [[ 环境 ]] ,防止未经初始化的变量被引用。
10.系统运行之初,要对加载到系统中的数据进行一致性检查。
11.严禁随意更改其它模块或系统的有关设置和配置。
15.不使用与硬件或操作系统关系很大的语句,而使用建议的标准语句。
16.建议:使用第三方提供的软件开发工具包或控件时,要注意以下几点:
(1)充分了解应用接口、使用环境及使用时 [[ 注意 ]] 事项。
(2)不能过分相信其正确性。
(3)除非必要,不要使用不熟悉的第三方工具包与控件。
==代码编译==
1.编写代码时要注意随时保存,并定期备份,防止由于断电、硬盘损坏等原因造成 代码丢失。
2.同一项目组内,最好使用相同的编辑器,并使用相同的 [[ 设置 ]] 选项。
3.合理地设计软件系统目录,方便开发人员使用。
4.打开编译器的所有告警开关对程序进行编译。
5.在同一项目组或产品组中,要统一编译开关选项。
6.使用工具软件(如VisualSourceSafe)对代码版本进行 [[ 维护 ]] 。
==代码测试==
单元测试要求至少达到语句 [[ 覆盖 ]] 。
单元测试开始要跟踪每一条语句,并观察数据流及变量的变化。
清理、整理或优化后的代码要经过审查及 [[ 测试 ]] 。
==常见编码规则==
== 参考来源 ==
<center>{{reflist#iDisplay:g0304ibqvlm|480|270|qq}}<center>会计实务操作-财务技能微课-固定资产的编码规则</center></center>== 参考资料 ==
[[Category: 990 遊藝及休閒活動總論]]