文档介绍：软件设计规范
制定:
审核:
批准:
文件编号
生效日期
版本号
分
发
部
门
修订履历
序号
版本
修订内容
修订人
修订日期
会签与文件发放:
会签部门
会签人
会签日期
签收部门
签收人
签收日期
深圳市德卡科技有限公司
文件编号
文件版本
A1
生效日期
软件设计规范
发行类别
■新增□修订
发行部门
研发中心
目录
第一章、项目模块划分 15
一、模块划分 15
二、模块命名 15
第二章、文件格式 15
一、c文件格式说明: 16
1、文件创建及修改说明区 16
2、头文件引用区 16
3、全局变量定义区 16
4、驱动函数区 16
5、应用函数区 17
6、文件结束说明 17
二、h文件格式说明 17
1、文件创建及修改说明区 17
2、防重调用定义 18
3、头文件引用 18
4、控制接口定义区 18
5、常量定义区 19
6、宏调用定义区 19
7、类型定义区 19
8、外部引用变量区 19
9、外部引用函数区 20
10、操作流程说明区 20
11、文件结束说明 20
第三章、命名规则 21
深圳市德卡科技有限公司
文件编号
文件版本
A1
生效日期
软件设计规范
发行类别
■新增□修订
发行部门
研发中心
一、函数命名规则 21
二、变量命名规则 21
三、宏命名规则 22
四、文件命名规则 22
五、新定义变量类型命名规则 22
六、命名注意事项: 22
1、标识符命名基本原则 23
2、命名中若使用特殊约定或缩写,则要有注释说明 23
3、局部循环变量也必须按照变量命名规则来定义 23
4、不要用数字或较奇怪的字符来定义标识符 23
5、用正确的反义词组命名具有互斥意义的变量或相反动作的函数等 23
6、避免使用以下划线开始和结尾的定义 23
7、程序中不要出现仅靠大小写区分的相似的标识符 23
8、标识符缩写 24
9、函数名应准确描述函数的功能 24
10、避免使用无意义或含义不清的动词为函数命名 24
第四章、代码书写规范 24
一、基本原则 24
二、排版 24
1、缩进风格 24
2、不要使用【TAB】键 24
3、空行 24
4、语句长度要小于80个字符 25
5、长语句换行 25
6、长表达式换行 26
7、若函数的参数较长,则要进行适当的划分 26
8、一行只写一条语句 26
9、括号{} 27
深圳市德卡科技有限公司
文件编号
文件版本
A1
生效日期
软件设计规范
发行类别
■新增□修订
发行部门
研发中心
10、语句缩进要求 27
11、分界符 28
12、空格 29
三、注释 30
1、注释量 30
2、函数头部注释 30
3、代码与注释同时修改 31
4、注释的内容要清楚、明了,含义准确,防止注释二义性 31
5、避免在注释中使用缩写,特别是非常用缩写 31
6、注释书写位置 31
7、变量、常量命名不能充分自注释的,必须加以注释 32
8、数据结构命名不能充分自注释的,必须加以注释 32
9、全局变量注释 32
10、注释要与说描述的内容进行同样的缩排 32
11、将注释与其上面的代码用空行隔开 33
12、连续case语句处理时,必须编写注释 34
13、代码或表达式的中间禁止插入注释 36
14、通过正确命名使代码成为自注释的 36
15、在代码的功能、意图层次上进行注释,提供有用、额外的信息 36
16、在程序块的结束行右方加注释标记,以表明某程序块的结束 36
17、注释格式 37
18、采用中文注释 37
19、使用#if0和#endif注释代码块 37
20、注释不能嵌套 37
四、代码可读性 37
1、使用小括号明确表达式的操作顺序 37
2、用有意义的枚举和宏替代数字 38
3、源程序中关系较为紧密的代码应尽可能相邻 39
深圳市德卡科技有限公司
文件编号
文件版本
A1
生效日期
软件设计规范
发行类别
■新增□修订
发行部门
研发中心
4、用多行简单语句替代复杂语句 39
五、变量,结构 40
1、公共变量 40
、去掉没必要的公共变量 40
、仔细定义并明确公共变量的含义、作用、取值范围及公共变量间的关系 40
、明确公共变量与操作此公共变量的函数或过程的关系 40
、要谨慎向公共变量传递数据 40
、防止局部变量与公共变量同名。 40
、公共变量仅由模块或函数创建和修改,其余