程序设计和编码规范

《程序设计和编码规范》由会员分享，可在线阅读，更多相关《程序设计和编码规范（10页珍藏版）》请在金锄头文库上搜索。

1、目 录1总体要求32命名规范32.1概述32.2文件命名规范32.3函数命名规范32.4变量命名规范32.5常量命名规范42.6数据库表命名规范43注释规范43.1概述43.2代码文件的注释43.3数据对象的注释54程序书写格式54.1空格、空行与缩进54.2SQL语句书写规范54.3其它规范64.4详细和编辑页的权限判断顺序65编程准则65.1变量使用规范65.2数据库操作规范65.3对象使用规范65.4模块设计原则65.5数据库表设计原则76界面设计规范76.1基本原则76.2版面样式76.3保持页面的一致性76.4文字表述76.5B/S构架适用原则87主要名词/动词汉英对照表88缩写标准

2、98.1常用缩写98.2前缀缩写98.2.1类型前缀98.2.2控件前缀10程序设计和编码规范1 总体要求1、 必须严格执行本规范以确保源代码的可读性及可维护性。2、 所有的程序文件都必须有注释文字，并严格按照本规范中的“注释规范”书写。3、 必须使用泰捷控件库提供的公用控件和公用函数。4、 同一个项目中必须使用相同的开发语言。5、 保持每个程序文件的程序书写格式一致，功能相似的页面控件引用顺序也应该是一致的。2 命名规范2.1 概述1、 必须使用美国英语标准英文单词，不允许使用中文拼音（中文地名和人名除外）。2、 选择使用频率较高的常用词。3、 如果有名词，必须使用单数形式。4、 使用大小写

3、混合格式，将连接的几个单词首字母大写。5、 必须在3至30个字母以内,临时的循环变量可以使用一个字母，如i，j，k等。6、 如果使用缩写，必须使用本规范附录的缩写范例。2.2 文件命名规范1、 文件命名采用主谓结构，首字母大写，如CustomerEdit.aspx。2、 文件和文件夹的名称应该精确地说明它们的用途。2.3 函数命名规范1、 函数名和方法名以动词开始，首字母大写，如SaveFileLog。2、 在命名函数时包括返回值的说明，如GetFileName。3、 类名和属性名以名词开始，不加前缀，首字母大写，如EmployeeName。4、 在不同的类中的属性，如果它们有相同的作用，则必

4、须使用同样的名称。2.4 变量命名规范1、 变量可以加前缀，前缀使用2至4个字母，全部小写；public变量不要加前缀。2、 避免与数据字典中的数据元素名相同。3、 避免与函数名、方法名、类名和属性名相同。4、 在同一个程序文件中，避免使变量名为另一个变量名的一部分。2.5 常量命名规范1、 常量所有字母都应该大写，单词之间可以用下划线连接。2.6 数据库表命名规范1、 库表名称必须使用前缀T_，例如T_CustomerInfo。2、 视图名称必须使用前缀V_，例如V_CustomerInfo。3、 存储过程名称必须使用前缀P_，例如P_GetAllCustomer。4、 根据项目的不同，前缀

5、有所不同，例如Tb_、Pc_等，在同一个项目同中，前缀必须一致。5、 字段名称使用小写，每个单词之间加下划线，例如：customer_name。3 注释规范3.1 概述1、 注释必须使用中文及中文的标点符号。2、 每行注释的最大长度为100个字符。3、 将注释与注释分隔符用一个空格分开。4、 不允许给注释加外框。5、 编码的同时书写注释。6、 重要变量必须有注释。7、 变量注释和变量在同一行，所有注释必须对齐。8、 典型算法必须有注释。9、 在循环和逻辑分支的地方必须写上注释。10、 程序段或语句的注释在程序段或语句的上一行。11、 在代码交付之前，必须删掉临时的或无关的注释。12、 被注释的

6、代码必须加上必要的注释，以说明这些代码被注释的原因。13、 对控件属性的赋值语句本身不需要注释，只有所赋值来源比较复杂时才需要特别注释说明。3.2 代码文件的注释1、 代码文件的头部必须有概述注释信息。2、 代码文件的概述注释，包括以下内容：a) 属性（主要功能）b) 创建人c) 创建时间每次有重要更新时，必须在文件头增加更新历史，包括以下内容：a) 更新人b) 更新时间c) 更新说明3、 泰捷控件库中的公用控件和公用函数的方法或属性等必须添加必要的智能提示。3.3 数据对象的注释1、 每个数据对象包括表、字段和存储过程等，都必须作相关的注释说明。2、 触发器和存储过程注释信息必须包括以下内容

7、：a) 功能b) 作者c) 日期d) 更新历史4 程序书写格式4.1 空格、空行与缩进1、 在操作符的前后必须使用空格。2、 在分隔数组下标和函数参数的逗号后面必须添上空格。3、 一个程序段上下必须使用空行。4、 变量定义部分与程序语句之间必须使用空行。5、 利用缩进来显示程序的逻辑结构，缩进量一致并以Tab键为单位，定义Tab键为4个空格字符。6、 使用编程工具的智能排版实现以下程序缩进：1) function 2) void 3) if else 4) for 5) switch 6) foreach 7) while 8) try catch 4.2 SQL语句书写规范1、 写SQL语句

8、时，关键字使用大写（如SELECT、WHERE等）。2、 把每个SQL子语句分开放在不同的行中。4.3 其它规范1、 不允许使用纯粹的不带语意的数字或字符串。比如：for (int i = 1; i 7; i+)；2、 而应该使用定义过的常量，比如：for (int i = 1; i NUM_DAYS_IN_WEEK; i+)。3、 主要变量放在函数的最前面，并分类排列。4.4 详细和编辑页的权限判断顺序1、 首先判断是否有浏览该页的权限；2、 然后判断记录是否存在；3、 最后判断是否有编辑和删除权限。5 编程准则5.1 变量使用规范1、 不允许随意定义public变量。2、 一个变量只能有一

9、个用途；变量的用途必须和变量的名称保持一致。5.2 数据库操作规范1、 查找数据库表或视图时，只能取出确实需要的那些字段，尽量避免使用(*)通配符。2、 使用无关子查询，而不要使用关联子查询。3、 清楚明白地使用列名，而不能使用列的序号。5.3 对象使用规范1、 尽可能晚地创建对象，并且尽可能早地释放它。5.4 模块设计原则1、 函数功能单一，不允许一个函数实现两个及两个以上的功能。2、 不能在函数内部使用全局变量，如要使用全局变量，应转化为局部变量。3、 函数与函数之间只允许存在包含关系，而不允许存在交叉关系。即两者之间只存在单方向的调用与被调用，不存在双向的调用与被调用。4、 调用头部控件

10、、底部控件、一览控件、编辑控件、详细控件等公用控件时不需要写函数进行封装。5、 多下拉等属性较多的控件必须用函数封装，放在模块的公用类中，并且可以给其他页面复用。6、 取得数据源、查询条件以及进行业务逻辑判断的时候语句超过5行的，必须使用函数。5.5 数据库表设计原则1、 每个库表都必须包含一个自动增加的字段为库表的主键。2、 选择数字类型和文本类型时字段长度尽量充足。3、 数字类型字段整型使用INT，非整型使用DECIMAL。4、 整型和布尔型字段需要设置默认值。5、 每个实体表中应该包含以下有用的字段：1) created_time（datetime，创建时间）在SQL Server 下设

11、置默认值为GETDATE()2) creator_name（nvachar，创建人）保存创建记录的用户名3) updated_time（datetime，更新时间）保存最近更新时间4) updater_name（nvachar，更新人）保存最近更新记录的用户名5) record_order（int，记录排序）6 界面设计规范6.1 基本原则1、 明确性：界面每个元素都应该有其存在的理由。2、 一致性：系统风格和操作方式必须保持一致。3、 简洁性：操作简洁，实现功能目标的点击数尽可能少，鼠标移动距离尽可能短。4、 人性化：界面中的文字表述和图标含义力求简单清晰。6.2 版面样式1、 必须使用统一

12、的头部控件、尾部控件和导航条控件。2、 必须使用统一的样式表和图片库。3、 同一个图标只能表示一个含义；相同的功能（操作）必须使用相同的图标来表示。4、 控件间距必须统一。6.3 保持页面的一致性1、 一览、详细和编辑页使用的字段名称及顺序必须保持一致。2、 下拉选项中的“全部”和“请选择”等必须使用英文字符的括号“()”。3、 下拉列表前的提示文字后不加冒号。6.4 文字表述1、 口语化、客气，不要用或少用专业术语，杜绝错别字。2、 使用中文标点符号，提示信息比较多的话，应该分段。3、 必须使用统一的用户提示效果和统一的语言描述。4、 编辑保存时的提示文字和符号使用规范。1) 提示文字的作用

13、不是要求用户去做什么事情，而是告诉用户系统有些什么规则，不允许出现“请重新输入”、“请正确输入”之类的文字。2) 提示文字必须清楚地告诉用户应该怎么做才符合系统规则，不允许出现“输入不合法”、“输入不正确”之类的文字。3) 提示文字示例：A. 时间的提示文字a) 时间不能小于零。b) 时间不能大于8小时。B. 数量的提示文字：a) 数量必须大于零。b) 数量不能小于已出库数量。C. 判断重复的提示文字a) “物资编码”不能重复，您输入的物资编码：0601010001已经存在。b) 2011年1月12日早班生产日报已经存在。4) 提示与报错信息不允许使用感叹号（!），而应该使用句号。6.5 B/

14、S构架适用原则1、 页面最小：由于Web的网络特性，尽可能减小单页面加载量，降低图片文件大小和数量，加快加载速度，方便用户体验。2、 屏幕适应：Web界面需要适应不同用户屏幕大小。3、 浏览器兼容：需要适应不同浏览器浏览效果，虽然目前可不考虑不同浏览器差别，但仍需考虑IE浏览器版本差异带来的客户端不同效果。4、 最少垂直滚动：尽可能减少垂直方向滚动，尽可能少于两屏。5、 禁止水平滚动：由于将导致非常恶劣的客户体验，尽可能禁止浏览器水平滚动操作。7 主要名词/动词汉英对照表附件Attach一览List详细Detail编辑Edit修改Modify变更Alter8 缩写标准8.1 常用缩写addraddress（地址）arrarray（数组）bgbackground（背景）catecategory（种类）corpcorporation(公司)govgovernment（政府）imgimage(图像)incinclude(包括、包含)Infoinformation（信息）MaxMinimum（最小值）MinMaximum（最大值）Msgmessage（消息）N