-
软件开发流程规范
目录
目录
.......................................
................................
0
一、
概述
..............
..................................................
..
2
二、
开
发流程规范
.............................
3
2.1
系统软硬件开发环境
.
...............................
..................
3
2.2
系统架构（系统组成）
.
..............................
.................
5
2.3
系统功能模块设计
.
................................
...................
6
2.4
系统功能开发流程图
.
...............................
..................
7
2.5
开发修改记录
.
..................................
.....................
8
三、
开
发代码规范
.................................................
..........
9
3.1
文件结构
.
....................................
.......................
9
3.1.1
文件信息声明
.........
.....................................
10
3.1.2
头文件的结构
............................................ .....
12
3.1.3
定义文件的结构
...........................................
....
15
3.1.4
头文件的作用
..........................................
....
17
3.1.5
目录结构
.............................................
......
18
3.2
命名规则
.
....................................
......................
18
3.2.1
共性原则
............
.......................................
19
3.2.2
Windows
变量命名规则
.......................................
21
3.3
程序风格
.
....................................
......................
24
3.3.1
空行
..............
.........................................
25
3.3.2
代码行
< br>............................................... ........
26
3.3.3
代码行内的空格
...........................................
....
29
3.3.4
对齐
< br>............................................... ........
31
3.3.5
长行拆分
.............................................
......
33
3.3.6
修饰符的位置
............................................ .....
35
3.3.7
注释
< br>............................................... ..........
35
3.4
函数设计
.
....................................
......................
40
3.4.1
参数的规则
...........
......................................
40
3.4.2
返回值的规则
............................................ .....
42
3.4.3
函数内部实现的规则
.........................................
..
47
3.4.4
其它建议
..............................................
.......
50
3.4.5
使用断言
..............................................
.......
50
3.4.6
引用与指针的比较
<
/p>
........................................
..
52
3.5
变量类型定义
.
.................................
....................
56
四、
软
件测试规范
................................................ .........
56
4.1
单元测试
.
....................................
......................
57
4.2
系统测试
..............................
57
4.6
业务测试
..............................
59
4.7
验收测试
..............................
59
4.8
用户现场测试
............................
59
五、软件版本管理
..............................
60
4.1
版本管理的必要性
..........................
60
、概述
本文制定烟台开发区德联软件有限责任公司计算机软件开发规范文档。
本规
范的目
的是使公司软件开发项目阶段清晰、
要求明确、任务具体、
编写的代码规
范，使之规范
化、
系统化和工程化，
向公司内从事软件开发的工程师和管理人员
提出一系列规范和要
求，
从而有利于开发过程的控制和管理，
提高所开发软件系
统的质量，缩短开发时间，
减少开发和维护费用，
以保证项目高质量、
顺利进行。
本规范包含：
开发流程规范和开发代码规范等，
开发流程规范需要技术开发
人员编
写相关内容，
希望每个技术人员形成习惯，
如有新的内容更新会及时通知
大家，
如有好
的规范要求也可通知编制人员及时更新。
本规范为烟台开发区德联软件有限责任公司内部材料，严禁其他商业应用。
、
开发流程规范
接受开发任务，详细阅读软件技术规范或技术文
档，如对技术文档有疑义或
者不清
楚
的地方及时与项目总工或用户沟通，
根据文档和沟通内容编写项目开发
计划，必须包
括但不限于
系统软硬件开发环境、系统架构、系统功能模块设计、
系统功能开发流程
图、开发修改记录。
2.1
系统软硬件开发环境
开发环境的搭建，最好形成文档，便于以后同样工作的使用。开发人员要明
确系统
开发拟采用的数据库、操作系统、开发语言、开发工
具、服务器等（具体
到版本）。明
确
整个系统开发工作流程，至少应该包括以下流程。
项目启动
项目前期
需要变更
系统实现
未通过
系统调试测试
未通过
项目后期
获取用户需求
用户需求文档
需求分析
系统结构建立
功能模块设计
编码实现
是否需要变更
…
无需变更
....
技术调试
集成调试
通过
试用
上线验收
结束
2.2
系统架构（系统组成）
确定系统整体体系架构
,
件配置及用户硬件资源配置
,
绘制架构图时给出基本框架
,
中的图片
各层次之间的数据流的连接
,
确定软件服务器的硬
开发人员在
确定与用户软件平台的统一协调
能反映出基本意义即可，可以直接用文字代替例子
样
测
配变监测低压朗少
颤赠交僵
U
■ II.
] 1
号接只鮎■舉也晶
■
通瞬人鬧
”
“
|
」」
1 I
综合魏摒
J
外加口
I
/
1r
」
/
主
詁
系
细
-
供壬畫
If 31
垃?
用
电
现
is
图
1
系统逻辑架构图举例
调厘槟姒屏
保护工作站
主前垃机
缱护工作站
电能计
量工作
图
2
物理架构图举例
2.3
系统功能模块设计
给出系统的主要功能模块，每个模块所包含的功能
用
尸
修
改
亠
圈
节
修
改
用
尸
査
询
「
用
尸
妥
录
图
3
图书管理系统模块规划图举例
系统功能开发流程图
给出系统主要功能的业务流程图
图<
/p>
4
系统功能业务流程图举例
停
止
电
泡
放
?
电
?
2.4
2.5
开发修改记录
1.
开发代码做好备份（可以在完成一个重大功能之后，或者按时间周期性
进行备
份），以免由于不可抗力导致代码
不可修复。
2.
在每次重大修改之后
要做好记录（改动的具体细节），修改前的版本要及
时备份，
可以方面随时还原系统。
修改日期
修改内容
是否备份
备注
三、开发代码规范
在研究项目团队协
作开发的情况下
(
这里的团队协作也适合于应用项目的开
发
)
，编程
时应该强调的一个重要方面是程序的易读性，在保证软件速度等性能
指标能满足用户需求
的情况下，
能让其他程序员容易读懂你所编写的程序。
若研
究项目小组的所有开发人员
都遵循统一的、
鲜明的一套编程风格，
可以让协作者、
后继者和自己一目了然，
在很
短的时间内看清楚程序结构，
理解设计的思路，
大
大提高代码的可读性、可重用性、
程
序健壮性、可移植性、可维护性。
制定本编程规范的目的是为了提高软件开发效率及所开发软件的可维护性，
提高软件
的质量。本规范由程序风格、命名规范、注释规范、程序健壮性、
可移
植性、错误处理以
及软件的模块
化规范等部分组成。
此规范以
C/C++
程序设计讨论。
3.1
文件结构
每个
C++/C
程序通常分为两个文件。一个文件用于保存程序的声明
(
declaration
)
，
称
为
头
文
件
。
另
一
个
文
件
用
于
保
存
程
序
的
实
现
(
implementation
)
，称为定义
(
definition
)
文件。
C++/C
程序的头文件以“
.h
”为后缀，
C
程序的定义文件以“
.c
”为后缀，
C++
程
序的定义文件通常以“
.cpp
”为后缀
(
也有一些系统以“
.cc
”或“
.cxx
”
为后缀
)
。