代码规范率

竭诚为您提供优质文档/双击可除

代码规范率

篇一：数据库设计编码规范

sqlserve数据库设计规范

一、数据库命名规范：

对象前缀命名：前缀命名一般用小写

表的前缀：业务模块组名前缀

数据列的前缀：一般采用列的数据类型做前缀

存储过程前缀：udp，系统存储过程（sp）

自定义函数前缀：udf(userdefinefunction)

视图前缀：udv(userdefineView)表示用户自定义视图自定义规则前缀：udr(userdefinerule)用户自定义规则

自定义约束前缀：uck(userchecker)用户自定义约束

索引前缀：idx(index)表示索引

主键前缀：pk(primarykeys)表示主键

数据列的前缀示例：

二、数据库设计规范：

1、每个表中都可以考虑添加的的几个有用的字段

Recoredid，记录唯一编号，不建议采用业务数据作为记录的唯一编号

creationdate，在sqlserver下默认为getdate()

Recordcreator，在sqlserver下默认为notnulldeFaultuseR

RecordVersion，记录的版本标记；有助于准确说明记录中出现null数据或者丢失数据的原因

2、数据类型：

字符类型

一般不建议采用char而采用varchar数据类型，除非当这列数据的长度特别固定时可以考虑用char。

数值类型

如果表示金额货币建议用money型数据，

如果表示科学记数建议用numeric数据类型

记录标识

一般采用int类型标识唯一一行记录。

自增or非自增

3、索引：

所有的表都应该有一个主键索引，这对提高数据库的性能很有帮助

根据使用频率决定哪些字段需要建立索引，选择经常作为连接条件、筛选条件、聚合查询、排序的字段作为索引的

候选字段。

把经常一起出现的字段组合在一起，组成组合索引，组合索引的字段顺序与主键一样，也需要把最常用的字段放在前面，把重复率低的字段放在前面。

一个表不要加太多索引，因为索引影响插入和更新的速度。

4、保证数据的一致性和完整性：

主外键关联

sqlseRVeR的主键同时是一个唯一索引

外键是最高效的一致性维护方法，数据库的一致性要求，依次可以用外键check

约束、规则约束、触发器、客户端程序，一般认为，离数据越近的方法效率越高。谨慎使用级联删除和级联更新

5、建立约束实现数据有效性检测

a、可以为某一列特别重要的值建立好约束。

例如：需要凭数据库里面的salekind列数据判定销售

类别，0值为门店销售，1为网上销售。系统只有这两种销

售渠道，就应该为它建立约束，它的值只能在0和1之间。即salekind>0andsalekind3

b、设置默认值

适当的设置默认值。

4、视图

数据的安全性还可以用视图来控制。

视图可以把用户关心的那部分数据显示给用户，而把无关的数据隐藏起来。

5、安全性：

操作数据库不建议用sa用户，因为sa用户权限过大。具体的应用应该创建相应的数据库操作用户，并只赋给它指定数据库操作的权限！

6、编码

所有程序员要有性能意识，也就是在实现功能同时有考虑性能的思想，数据库是能进行集合运算的工具，我们应该尽量的利用这个工具，所谓集合运算实际是批量运算，就是尽量减少在客户端进行大数据量的循环操作，而用sql语句或者存储过程代替。

a、只返回需要的数据。

横向来看，不要写select*的语句，而是选择你需要的字段。

纵向来看，合理写wheRe子句，不要写没有wheRe的sql 语句。

注意selectinto后的wheRe子句，因为selectinto把数据插入到临时表，这个过程会锁定一些系统表，如果这个wheRe子句返回的数据过多或者速度太慢，会造成系统表长期锁定，诸塞其他进程。

对于聚合查询，可以用haVing子句进一步限定返回的行。

b、注意临时表和表变量的用法

在复杂系统中，临时表和表变量很难避免，关于临时表和表变量的用法，需要注意：如果语句很复杂，连接太多，可以考虑用临时表和表变量分步完成；

如果需要多次用到一个大表的同一部分数据，考虑用临时表和表变量暂存这部分数据；如果需要综合多个表的数据，形成一个结果，可以考虑用临时表和表变量分步汇总这多个表的数据；

其他情况下，应该控制临时表和表变量的使用；

关于临时表和表变量的选择，很多说法是表变量在内存，速度快，应该首选表变量，但是在实际使用中发现，这个选择主要考虑需要放在临时表的数据量，在数据量较多的情况下，临时表的速度反而更快。

关于临时表产生使用selectinto和

cReatetable+inseRtinto的选择，我们做过测试，一般情况下，selectinto会比cReatetable+inseRtinto的方法快很多，但是selectinto会锁定tempdb的系统表sysobjects、sysindexes、syscolumns，在多用户并发环境下，容易阻塞其他进程，所以我的建议是，在并发系统中，尽量使用cReatetable+inseRtinto，而大数据量的单个语句使用中，

使用selectinto。

注意排序规则，用cReatetable建立的临时表，如果不指定字段的排序规则，会选择tempdb的默认排序规则，而

不是当前数据库的排序规则。如果当前数据库的排序规则和tempdb的排序规则不同，连接的时候就会出现排序规则的冲突错误。一般可以在cReatetable建立临时表时指定字段的排序规则为database_deFault来避免上述问题。

三、sql编码优化：

设计阶段

设计阶段可以说是以后系统性能的关键阶段，在这个阶段，有一个关系到以后几乎所有性能调优的过程—数据库设计。

在数据库设计完成后，可以进行初步的索引设计，好的索引设计可以指导编码阶段写出高效率的代码，为整个系统的性能打下良好的基础。

以下是性能要求设计阶段需要注意的：

1、数据库逻辑设计的规范化

数据库逻辑设计的规范化就是我们一般所说的范式，我们可以这样来简单理解范式：第1规范：没有重复的组或多值的列，这是数据库设计的最低要求。

第2规范:每个非关键字段必须依赖于主关键字，不能

依赖于一个组合式主关键字的某些组成部分。消除部分依赖，

大部分情况下，数据库设计都应该达到第二范式。

第3规范:一个非关键字段不能依赖于另一个非关键字段。消除传递依赖，达到第三范式应该是系统中大部分表的要求，除非一些特殊作用的表。

更高的范式要求这里就不再作介绍了，个人认为，如果全部达到第二范式，大部分达到第三范式，系统会产生较少的列和较多的表，因而减少了数据冗余，也利于性能的提高。

2、合理的冗余

完全按照规范化设计的系统几乎是不可能的，除非系统特别的小，在规范化设计后，有计划地加入冗余是必要的。

冗余可以是冗余数据库、冗余表或者冗余字段，不同粒度的冗余可以起到不同的作用。冗余可以是为了编程方便而增加，也可以是为了性能的提高而增加。从性能角度来说，冗余数据库可以分散数据库压力，冗余表可以分散数据量大的表的并发压力，也可以加快特殊查询的速度，冗余字段可以有效减少数据库表的连接，提高效率。

3、主键的设计

主键是必要的，sqlseRVeR的主键同时是一个唯一索引，而且在实际应用中，我们往往选择最小的键组合作为主键，所以主键往往适合作为表的聚集索引。聚集索引对查询的影响是比较大的，这个在下面索引的叙述。

在有多个键的表，主键的选择也比较重要，一般选择总

的长度小的键，小的键的比较速度快，同时小的键可以使主键的b树结构的层次更少。

主键的选择还要注意组合主键的字段次序，对于组合主键来说，不同的字段次序的主键的性能差别可能会很大，一般应该选择重复率低、单独或者组合查询可能性大的字段放在前面。

4、外键的设计

外键作为数据库对象，很多人认为麻烦而不用，实际上，外键在大部分情况下是很有用的，理由是：

外键是最高效的一致性维护方法，数据库的一致性要求，依次可以用外键、check约束、规则约束、触发器、客户端

程序，一般认为，离数据越近的方法效率越高。

谨慎使用级联删除和级联更新，级联删除和级联更新作为sqlseRVeR2000当年的新功能，在20xx作了保留，应该

有其可用之处。我这里说的谨慎，是因为级联删除和级联更新有些突破了传统的关于外键的定义，功能有点太过强大，使用前必须确定自己已经把握好其功能范围，否则，级联删除和级联更新可能让你的数据莫名其妙的被修改或者丢失。从性能看级联删除和级联更新是比其他方法更高效的方法。

5、字段的设计

字段是数据库最基本的单位，其设计对性能的影响是很大的。需要注意如下：

a、数据类型尽量用数字型，数字型的比较比字符型的快很多。

b、数据类型尽量小，这里的尽量小是指在满足可以预见的未来需求的前提下的。

c、尽量不要允许null，除非必要，可以用

notnull+deFault代替。

d、少用text和image，二进制字段的读写是比较慢的，而且，读取的方法也不多，大部分情况下最好不用。

e、自增字段要慎用，不利于数据迁移。

6、数据库物理存储和环境的设计

在设计阶段，可以对数据库的物理存储、操作系统环境、网络环境进行必要的设计，使得我们的系统在将来能适应比较多的用户并发和比较大的数据量。

这里需要注意文件组的作用，适用文件组可以有效把

i/o操作分散到不同的物理硬盘，提高并发能力。

7、系统设计

整个系统的设计特别是系统结构设计对性能是有很大

影响的，对于一般的oltp系统，可以选择c/s结构、三层的c/s结构等，不同的系统结构其性能的关键也有所不同。

系统设计阶段应该归纳一些业务逻辑放在数据库编程

实现，数据库编程包括数据库存储过程、触发器和函数。用数据库编程实现业务逻辑的好处是减少网络流量并可更充

C语言注释规范

C语言注释规范 1.注释原则 同一软件项目开发中，尽量保持代码注释规范和统一。 注释方便了代码的阅读和维护。 边写代码边注释，修改代码时要相应修改注释，保证注释和代码的一致性。 注释要简洁明确，不要出现形容词。 对于写的好的注释，我们将是第一个受益者。 大型软件开发中，通过别人的注释可以快速知道他人所写函数的功能，返回值，参数的使用。 2.文件头部的注释 示例： / * Program Assignment : 该文件的作用 * Author: 作者 * Date: 2013/8/6 14:34 * Description: 该文件的描述 *****/ /* * Source code in : 源代码的路径 * Function List: * initLinear 初始化线性表 * destoryLinear 释放线性表申请的空间 * isLinearEmpty 判断线性表是否为空 * isLinearFull 判断线性表是否为满 * getLinearElementValue 取得下标为index的元素的值 */ 注意：这个函数列表可以快速查询到我们想要了解的函数。 3.结构体，全局变量等的注释 示例： typedef POLYNOMIAL USER_TYPE; /* 新的数据类型的描述*/ int a; /* 全局变量的作用*/ /* 说明结构体的功能*/ typedef struct LINEAR { USER_TYPE *data; /* 每个成员的意义(作用) */ int maxRoom; /* 每个成员的意义(作用) */

int elementCount; /* 每个成员的意义(作用) */ }LINEAR; 4.函数的注释 在逻辑性较强的的地方加入注释，以便其他人的理解，在一定的程度上排除bug。 示例： /* * Function Name: getLinearElementIndex * Purpose: 取得元素的index值 * Params : * @LINEAR linear 线性表实例 * @USER_TYPE var 类型为USER_TYPE的实例 * @int (*)() cmp 提供接口，让用户定义具体比较函数 * Return: int 返回元素的index值 * Limitation: 如果返回-1，则代表不存在var的元素 */ int getLinearElementIndex(LINEAR linear, USER_TYPE var, int (*cmp)()) { /* * 如果逻辑太过复杂，这里写明该算法的过程和思路。 */ boolean found = FALSE; int i; for(i = 0; i < && !found; i++) if(cmp[i], var) == 0) found = TRUE; if(i >= i = NOT_FOUND; return i; }

系统开发代码规范

系统开发代码规范北京慧点科技开发有限公司 2005年9月

目录 一、Domino网络域及组织的命名................................................................ 错误！未定义书签。 二、Domino服务器的命名............................................................................ 错误！未定义书签。 三、系统验证字的命名................................................................................. 错误！未定义书签。 四、用户和群组的命名................................................................................. 错误！未定义书签。 五、模块数据库的命名................................................................................. 错误！未定义书签。 六、数据库各设计元素的命名..................................................................... 错误！未定义书签。 七、编码规范................................................................................................. 错误！未定义书签。 八、产品开发规范......................................................................................... 错误！未定义书签。 九、提交数据库备份命名规范..................................................................... 错误！未定义书签。

代码编写规范

知识管理系统代码编写规范 一、介绍 本文档为《知识管理系统》代码编写规范，为保证代码风格的一致性和后期的可维护性，文档讲述的内容要求所有开发人员必须遵守。 本规范主要参考了Google Java Style，包括了其他一些业界约定俗成的公约和普遍采用的标准。本规范并非最终标准，一些规定还需再做商讨。 1.1 术语说明 本文档除非特殊说明，否则： 1. 类（class）统指普通类、枚举类、接口和注解类型。 2. 注释（comment）只用来指实现注释（implementation comments）。我们不使用“文 档注释”这样的说法，而会直接说Javadoc。 其他“术语说明”，将在文档中需要说明的地方单独说明。 1.2 文档说明 本文档中的代码并不一定符合所有规范。即使这些代码遵循本规范，但这不是唯一的代码方式。例子中可选的格式风格也不应该作为强制执行的规范。

二、源码文件基础 2.1 文件名 源文件以其最顶层的类名来命名，大小写敏感，文件扩展名为.java。 2.2 文件编码：UTF-8 源码文件使用UTF-8编码。 2.3 特殊字符 2.3.1 空格字符 除了换行符外，ASCII 水平空白字符（0x20）是源码文件中唯一支持的空格字符。这意味着： 1. 其他空白字符将被转义。 2. Tab字符不被用作缩进控制。 2.3.2 特殊转义字符串 任何需要转义字符串表示的字符（例如\b, \t, \n, \f, \r, \", \'和\\等），采用这种转义字符串的方式表示，而不采用对应字符的八进制数（例如\012）或Unicode 码（例如\u000a）表示。 2.3.3 非ASCII 字符 对于其余非ASCII字符，直接使用Unicode字符（例如∞），或者对应的Unicode 码（例如\u221e）转义都是允许的。唯一需要考虑的是，何种方式更能使代码容易阅读和理解。

产品使用说明书编写模板

使用说明书模板 根据所需改写即可 远程抄表能源管理系统 使用说明书 XXXXXXXX XXXX 年XX 月 文档控制 修改记录 * 修改类型分为A一Added M—Mod辻ied D—Deleted 审阅人 存档 目录 1醞

1.1背景 1.2应用领域与使用对象 1.4参考资料 1.5术语与缩耳解释 2系统综述 2.1系统结构 2.2系统功能简介 2.3性能 2.4版权声明 3运行环境 3.1硕件设备要求 3.2支持软件 3.3数据结构 4系统操作说明 4.1安装与初始化 4.2子模块名称1 4.2. 1业务需求描述 4. 2. 2界面截屏以及界面字段解释 4. 2. 3操作说明 4. 3子模块名称2 4. 3. 1业务需求描述 4. 3. 2界面截屏以及界面字段解释 4.4出错处理和恢复 4. 3. 3操作说明

1概述

1?1背景 系统的开发背景和编写这个手册的U的。 1.2应用领域与使用对象 描述软件所能使用的领域以及使用对象等。 1.4参考资料 列出有关资料的作者、标题、编号、发表日期、岀版单位或资料来源，可包括 与该产品有关的已发表的资料 文档中所引用的资料，所采用的软件标准或规范或业务规则 列岀编写本说明书时查阅的Internet上杂志、专业著作、技术标准以及他们的网址 1?3术语与缩写解释 2系统综述 4.4出错处理和恢复

2.1系统结构 结合系统所具有的功能包括输入、处理和输出提供该软件的总体结构图表。 2.2系统功能简介 结合本软件的开发实际逐项地说明本软件所有具有各项功能。 2.3性能 给出一般情况下的运行性能指数等。 2.4版权声明 声明版权所有者以及盗版应承当的法律责任。 3运行环境 3.1硬件设备要求 列出本软件所要求的硬设备的最小配置，如： 1、处理器的型号、内存、硬盘容量； 2、所要求的外存储器、媒体、记录格式、设备的型号和台数、联机/脱机; 3、I/O设备（联机/脱机）； 4、数据传输设备和转换设备的型号、台数。 3. 2支持软件

程序代码注释编写规范

程序代码注释编写规范 为提高控制程序的阅读性与可理解性，现制定相关代码程序代码注释编写的编写规范。 一般情况下，源程序有效注释量必须在20％以上，注释的原则是有助于对程序的阅读理解，在该加的地方都加了，注释不宜太多也不能太少，注释语言必须准确、易懂、简洁。 常规注释有以下两种方式。 单行:以"//"符号开始，任何位于该符号之后的本行文字都视为注释。 多行:以"/*"符号开始，以"*/"结束。任何介于这对符号之间的文字都视为注释。 一、说明性文件 说明性文件（如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等）头部应进行注释，注释必须列出：版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等，头文件的注释中还应有函数功能简要说明。 示例：下面这段头文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************* COPYRIGHT (C), MicTiVo International. Co., Ltd. File NAME: // 文件 Author: Version: Date: // 作者、版本及完成日期 DESCRIPTION: // 用于详细说明此程序文件完成的主要功能，与其他模块 // 或函数的接口，输出值、取值范围、含义及参数间的控 // 制、顺序、独立或依赖等关系 Others: // 其它内容的说明 Function List: // 主要函数列表，每条记录应包括函数名及功能简要说明 1.... History: // 修改历史记录列表，每条修改记录应包括修改日期、修改 // 者及修改内容简述 1. Date: Author: Modification: 2. .. *************************************************/ 二、源文件头 源文件头部应进行注释，列出：版权说明、版本号、生成日期、作者、模块目的/功能、主要函数及其功能、修改日志等。 示例：下面这段源文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************************ COPYRIGHT (C), MicTiVo International. Co., Ltd. FileName: Author:

项目开发及编码规范

项目开发规范文档修订历史记录

1.简介 目的 1、用于规范指导开发组进行开发 2、便于成员间的沟通与交流。 3、有助于项目质量和稳定。 4、为后期维护提供支持 2. 项目开发流程 项目开发过程归纳分为以下步骤： 1. 建立SVN项目版本控制。包括文档，源码，Lib包等。 2. 了解需求，并对需求文档的书写。(见文档结构规则附录)。 3. 详细设计文档。(见文档结构规则附录)。 功能模块设计，重要模块的算法设计。 数据库设计等。 根据需求定义开发平台及环境。 4. 编码。 搭建开发平台，配置开发环境。 编码。 单元测试案例。 5. 书写软件安装手册文件，数据库脚本文件，以及注意事项(release notes)。 6. 交互测试组测试。根据测试组测试结果是否回归第4步（测试回归最好不要超过2 次）。 7. 测试通过，交付上线使用。 维护手册 使用手册

3. 代码规范 Java 代码规范 3.1.1 Java类名 类名可由：英文字母，数字，下划线组成。（数字，下划线不能够开头） 类名由一个或者多个单词组成。单词通常要求简洁明了达意。能够通过类名能够大致了解此类的作用和用途。 类名要求首字母大写，多个单词组成类名时，单词的首字母要求大写。 建议：类名不要过于简单或者太长。可以对单词采用简化的名称：入： Number 简化为：num 。 3.1.2 Java类结构 类仅作为数据结构，没有行为，他封装了一组或者相似的一些行为方法。所以一个类尽量功能单一，或者功能类似共有行为的。一个类不要过于庞大。 通常情况下： 一般逻辑类中应该有构造方法和main方法，main方法中应该有测试代码。 每个类应该有 toString() 方法。 3.1.2.1 包和引入语句 在多数Java源文件中，第一个非注释行是包语句。在它之后可以跟引入语句。 报名的定义全部是小写字母。具体定义依据项目而定。 引入包时候，同一类型的归纳到一块，用空行隔开。例如： import 3.1.2 类注释 Java类开头应该有相应的注释：类版本描述，作者签名，日期时间，公司备注，类的功能作用相关描述等。（详细查看：注释） 3.1.2.2 类成员变量 a) 类变量要求放在类的开始声明。一行声明一个。 b) 变量名称首字母要求小写。其他命名规则类似与类名。 c) static , final 类型的变量，字母要求全部大写。 d) 尽量在声明局部变量的同时初始化。 e) 避免局部变量和成员变量同名，覆盖了成员变量。 f) 尽量变量私有化，缩小变量的作用域。 3.1.2.3 类成员方法 a) 方法名命名规则类似于成员变量命名规则。 b) 成员方法尽量私有化。

产品使用说明书编写规定

产品使用说明书编写规定 1 本标准规定了产品使用说明书的基本要求和编写方法。 本标准适应于湖北京山轻工机械股份有限公司产品使用说明书的编写。 2 引用标准 下列标准所包含的条文，通过在本标准中引用而构成为本标准的条文。本标准出版 时，所示版本均为有效。所有标准都会被修订，使用本标准的各方应探讨使用下列 标准最新版本的可能性。 工业产品使用说明书总则 JB/T5995 工业产品使用说明书机电产品使用说明书编写规定 3 基本要求 号或不同的字体表示， 或用特殊符号或颜色来强调。 使用说明书必须按下列等级和 告用 语提醒用户： —“危险”表示对高度危险要警惕； 表示对中度危险要警惕； 注意”表示对轻度危险要关注； 使用说明书应明确给出产品用途和适应范围， 并根据产品的特点和需要给出主要结 构、性 能、型式、规格和正确吊运、安装、使用、操作、维修、保养等的方法，以 及保护操作者 和产品的安全措施。 使用说明书内容的表述要科学、合理、符合操作程序，易于用户快速理解掌握。 对于复杂的操作程序，应多采用图示、图表、和操作程序图进行说明。 使用说明书中的图、表应和正文印在一起，图、表应按顺序编写序 3.8 具有几种不同和独 立功能的产品的使用说明书， 应先介绍产品的基本的和通常的功 能，然后再介绍其他方面的功能。 3.9 使用说明书应尽可能设想用户可能遇到的问题，并提供预防和解决的办法。 3.10应使用简明的标题和标注，以帮助用户快速找到所需内容。 3.11使用说明书应将机、电、气、液等融合一起编制，不能各行其是。 3.12外购件的使用说明书应附在相应的产品使用说明书上。编制产品使用说明书时， 除在产品使用说明书中简述其使用、 操作方法外， 还应注明详见某 某使用说 明书。 3.13使用说明书中的符号、代号、术语、计量单位应符合最新发布的国家法令、法规和 有关标 准的规定，并保持前后一致。 3.1 3.2 3.3 3.4 当需要时必须编制产品使用说明书，使用说明书是交付产品的组成部分。 使用说明书的开本幅面采用 16开，大于 16开的幅面应折页成 16 开。多页应装订 成册。 使用说明书可按产品型号编制， 也可按产品系列编制。 复杂产品和成套设备可按功 能单元、整机分别编制使用说明书， 再按产品型号、 用途组合成系统的使用说明书。 使用说明 书应对涉及安全方面的内容给出安全警告。 安全警告的内容应用较大的字 “做小” 3.5 3.6 3.7

程序代码注释编写规范

百度文库- 让每个人平等地提升自我 1 程序代码注释编写规范 为提高控制程序的阅读性与可理解性，现制定相关代码程序代码注释编写的编写规范。 一般情况下，源程序有效注释量必须在20％以上，注释的原则是有助于对程序的阅读理解，在该加的地方都加了，注释不宜太多也不能太少，注释语言必须准确、易懂、简洁。 常规注释有以下两种方式。 单行:以"文件、.inc文件、.def文件、编译说明文件.cfg等）头部应进行注释，注释必须列出：版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等，头文件的注释中还应有函数功能简要说明。 示例：下面这段头文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************* (C), MicTiVo International. Co., Ltd. 1.File : . History: Date: Author: Modification: 2. .. *************************************************/ 一、源文件头 源文件头部应进行注释，列出：版权说明、版本号、生成日期、作者、模块目的/功能、主要函数及其功能、修改日志等。 示例：下面这段源文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************************ (C), MicTiVo International. Co., Ltd. FileName: Author: Version : Date: : / /*receive _process() */ 意:与溢出中断写初值不同}

产品说明注意事项

工业产品使用说明书的编写方法 一、编写工业产品使用说明书的基本要求 编写工业产品使用说明书应符合下列四个方面基本要求： 1．应明确具体规定产品的用途和使用方法 要根据产品的使用功能和特点，具体而明确地写明产品的用途和适用范围，同时写明主要结构、性能参数、型式和规格以及正确贮运、安装、使用（操作）、维修、保护等方法。 产品使用说明书可按产品型号编写，也可按产品系列编写。 2．涉及到安全、卫生和环境保护等方面要求必须写明 当产品具有危险和有害因素时，必须在产品使用说明书中写明保护产品和操作者的安全卫生措施，对易燃、易爆、有毒、有腐蚀性和有放射性的危险产品，更应在使用说明书上规定防范措施、注意事项以及发生意外时的紧急处理办法等内容。 对影响环境的产品，使用说明书上还应规定必要的保护环境方面的内容。此外，对一些耗能较大产品应说明节能措施。 3．复杂产品和成套设备应编写系统的使用说明书

对一些复杂产品和成套设备，可按其功能单元、整机分别编写使用说明书，再组合成一套系统的使用说明书。 4．简单产品可不写使用说明书 对一些冶金、矿产、建材等原材料类产品以及用于组装配套的一些元器件、零部件等简单产品，如其产品标准、产品手册、质量证明书等有关技术文件能满足用户需要时，可由这些技术文件代管产品使用说明书，不必另行编写产品使用说明书。 二、产品使用说明书的内容构成 一般工业产品使用说明书应包括下列内容： 1．产品概述 产品概述部分主要写明产品的用途，适用范围（必要时还应写明不适用范围），产品规格型号的含义，使用环境条件或工作条件等方面内容。 2．结构特征与工作原理 该部分叙述产品结构特点及其工作原理，包括主要部件或功能单元的结构，作用及其工作原理，辅助装置的功能结构及工作原理和各单元之间的机电联系，故障告警系统等。

程序代码注释编写规范

程序代码注释编写规范 XXX份公司

为提高控制程序的阅读性与可理解性，现制定相关代码程序代码注释编写的编写规范。 一般情况下，源程序有效注释量必须在20％以上，注释的原则是有助于对程序的阅读理解，在该加的地方都加了，注释不宜太多也不能太少，注释语言必须准确、易懂、简洁。 常规注释有以下两种方式。 单行:以"//"符号开始，任何位于该符号之后的本行文字都视为注释。 多行:以"/*"符号开始，以"*/"结束。任何介于这对符号之间的文字都视为注释。 一、说明性文件 说明性文件（如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等）头部应进行注释，注释必须列出：版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等，头文件的注释中还应有函数功能简要说明。 示例：下面这段头文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************* COPYRIGHT (C), MicTiVo International. Co., Ltd. File NAME: // 文件 Author: Version: Date: // 作者、版本及完成日期 DESCRIPTION: // 用于详细说明此程序文件完成的主要功能，与其他模块 // 或函数的接口，输出值、取值范围、含义及参数间的控 // 制、顺序、独立或依赖等关系 Others: // 其它内容的说明 Function List: // 主要函数列表，每条记录应包括函数名及功能简要说明 1.... History: // 修改历史记录列表，每条修改记录应包括修改日期、修改 // 者及修改内容简述 1. Date: Author: Modification: 2. .. *************************************************/ 二、源文件头 源文件头部应进行注释，列出：版权说明、版本号、生成日期、作者、模块目的/功能、主要函数及其功能、修改日志等。 示例：下面这段源文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************************

java项目团队开发规范

项目团队开发规范

修订历史记录

目录 1引言 (6) 1.1 编写目的 (6) 1.2 预期读者 (6) 1.3 编写背景 (6) 2概述 (7) 2.1 目标 (7) 2.2 修改及完善 (7) 3详细规范 (7) 3.1 使用的工具 (7) 3.2 框架设计 (7) 3.3 包目录 (8) 3.4 编码规范 (10) 3.4.1 目的 (10) 3.4.2 依据 (10) 3.4.3 具体规范 (10) 3.4.3.1 编码风格 (10) 3.4.3.1.1 缩进 (10) 3.4.3.1.2 空格 (11) 3.4.3.1.3 对齐 (12) 3.4.3.1.4 空行 (12)

3.4.3.1.5 代码长度 (13) 3.4.3.1.6 行数 (13) 3.4.3.1.7 注释 (14) 3.4.3.2 代码效率 (17) 3.4.3.2.1 综述 (17) 3.4.3.2.2 具体实现 (17) 3.4.3.3 异常处理 (17) 3.4.3.3.1 处理CHECK 异常与UNCHECK异常 (17) 3.4.3.4 程序调试 (17) 3.4.4 日常交流 (18) 3.4.4.1 互相促进 (18)

1引言 1.1 编写目的 本文档作为项目团队开发规范的说明书，描述了项目开发过程中的使用的工具，框架，代码编写规范及注意问题，作为项目团队建设，开发及测试工作的依据。 1.2 预期读者 本文档的预期读者包括以下几类： ?项目组长 ?项目组全体成员 1.3 编写背景 根据公司现有的开发状况，决定组件稳定的项目开发团队，制定全体团队成员共识的开发规范，有助于提高项目开发的效率、项目团队整体水平的提升。

代码开发规范

代码开发规范 1 前言 1.1 为什么需要开发规范 编码规范对于程序员而言尤为重要，有以下几个原因： * 一个软件的生命周期中，80%的花费在于维护 * 几乎没有任何一个软件，在其整个生命周期中，均由最初的开发人员来维护* 编码规范可以改善软件的可读性，可以让程序员尽快而彻底地理解新的代码 * 如果你将源码作为产品发布，就需要确任它是否被很好的打包并且清晰无误，一如你已构建的其它任何产品 1.2 开发规范的作用 * 减少维护花费 * 提高可读性 * 加快工作交接 * 减少名字增生 * 降低缺陷引入的机会

2 命名规范 2.1 常量命名规范 2.1.1 类型 常量命名规范 2.1.2 说明 常量用于保存需要常驻内存中并且经常使用变化不多的数据，定义常量的名称的时候需要遵循望文知意的原则； 2.1.3 规则 1.全部为大写字母； 2.中间以“_”连接； 3.望文知意原则； 2.1.4 备注 代码中涉及到直接使用某个字符串或者其他基本类型的值时，建议定义成常量，避免多处直接使用同样的值作为参数。 2.1.5 举例 ?如：定义一个常量表示最小屏幕宽度的常量，则可以定义一个int类型的常 量，该常量可以命名为：“MIN_SCREEN_WIDTH“； ?其他举例： ?例如：static final int MIN_SCREEN_WIDTH = 4；( √) ?例如：static final int min_screen_width = 4;（×） ?例如：static final int minScreenWidth = 4; （×） ?例如：static final int WIDTH = 4；（×）

产品使用说明书编写规定

产品使用说明书编写规定 1本标准规定了产品使用说明书的基本要求和编写方法。 本标准适应于湖北京山轻工机械股份有限公司产品使用说明书的编写。 2引用标准 下列标准所包含的条文，通过在本标准中引用而构成为本标准的条文。本标准出版时，所示版本均为有效。所有标准都会被修订，使用本标准的各方应探讨使用下列标准最新版本的可能性。 GB9969.1 工业产品使用说明书总则 JB/T5995 工业产品使用说明书机电产品使用说明书编写规定 3基本要求 3.1当需要时必须编制产品使用说明书，使用说明书是交付产品的组成部分。 3.2使用说明书的开本幅面采用16开，大于16开的幅面应折页成16开。多页应装订 成册。 3.3使用说明书可按产品型号编制，也可按产品系列编制。复杂产品和成套设备可按功 能单元、整机分别编制使用说明书，再按产品型号、用途组合成系统的使用说明书。 3.4使用说明书应对涉及安全方面的内容给出安全警告。安全警告的内容应用较大的字 号或不同的字体表示，或用特殊符号或颜色来强调。使用说明书必须按下列等级和警告用语提醒用户： —“危险”表示对高度危险要警惕； —“警告”表示对中度危险要警惕； —“注意”表示对轻度危险要关注； 3.5使用说明书应明确给出产品用途和适应范围，并根据产品的特点和需要给出主要结 构、性能、型式、规格和正确吊运、安装、使用、操作、维修、保养等的方法，以及保护操作者和产品的安全措施。 3.6使用说明书内容的表述要科学、合理、符合操作程序，易于用户快速理解掌握。3.7对于复杂的操作程序，应多采用图示、图表、和操作程序图进行说明。 使用说明书中的图、表应和正文印在一起，图、表应按顺序编写序号。 3.8具有几种不同和独立功能的产品的使用说明书，应先介绍产品的基本的和通常的功 能，然后再介绍其他方面的功能。 3.9使用说明书应尽可能设想用户可能遇到的问题，并提供预防和解决的办法。 3.10应使用简明的标题和标注，以帮助用户快速找到所需内容。 3.11使用说明书应将机、电、气、液等融合一起编制，不能各行其是。 3.12外购件的使用说明书应附在相应的产品使用说明书上。编制产品使用说明书时，除 在产品使用说明书中简述其使用、操作方法外，还应注明详见某某使用说明书。 3.13使用说明书中的符号、代号、术语、计量单位应符合最新发布的国家法令、法规和 有关标准的规定，并保持前后一致。 3.14当产品结构、性能等改动时，使用说明书的有关内容必须按规定程序、及时作相应 修改。 4基本内容 4.1封面 封面一般应包括：产品型号、名称、使用说明书字样。 4.2次页

代码规范

目录 一．规范简介 1.1 目的 所有的程序开发手册都包含了各种规则。一些习惯自由程序人员可能对这些规则很不适应，但是在多个开发人员共同写作的情况下，这些规则是必需的。这不仅仅是为了开发效率来考虑，而且也是为了后期维护考虑。 本规范正是为培养规范设计和编程，养成良好的习惯，增强软件产品的稳定，健壮，可靠性；同时也为了提高软件的可读性，可以让程序员尽快而彻底地理解新的代码，使产品可维护性提高而制定的规范。 1.2 开发规范的重要性 （1）减少维护成本； 一个软件的生命周期中，80%的花费在于维护，另一方面，几乎没有任何一个软件，在其整个生命周期中，均由最初的开发人员来维护，规范的编码减少人员变动带来的维护成本。 （2）改善软件的可读性 可以让程序员尽快而彻底地理解新的代码。在一个团队中，代码也容易在程序员之间共享。 （3）维护部门交付产品的规范形象。 二．具体规范 2.1 注释 注释是软件可读性的具体表现。程序注释量一般占程序编码量的20%，软件工程要求不少于20%。程序注释不能用抽象的语言，要精确表达出程序的处理说明。避免每行程序都使用注释，可以在一段程序的前面加一段注释，具有明确的处理逻辑。 注释必不可少，但也不应过多，不要被动得为写注释而写注释。

2.1.1 需要注释的部分 （1）文件头注释，文件创建及修改记录，版权归属，作者以及修订者，以及对文件的简短描述。 （2）类的目的（即类所完成的功能）、设置接口的目的以及应如何被使用。 （3）成员方法注释（对于设置与获取成员方法，在成员变量已有说明的情况下，可以不加注释；普通成员方法要求说明完成功能，参数含义以及返回值）。 （4）普通成员方法内部注释（控制结构、代码所起到的作用以及如此编写代码的原因，处理顺序等）。 （4）参数的含义以及其他任何约束或前提条件、字段或属性描述。而对于局部变量，如无特别意义的情况下则不加注释。 2.1.2 具体注释 （1）文件头注释 要求：遵循JavaDoc的规范，在每一个源文件的开头注明该文件的作用, 作简要说明, 并写上源文件的作者,版权信息编写日期。如果是修改别人编写的源文件，要在修改信息上注明修改者和修改日期。 例子： /** * @Title: 文件名 * @Copyright (C) 年份龙图软件 * @Description: 文件信息描述 * @Revision History: * @Revision 版本号日期作者. */ （2）类和接口的注释 要求：遵循JavaDoc的规范，在每一个类的开头注明该类的作用，作简要说明，并写上作者，编写日期。 例子： /** * @ClassName: 类（或接口）名 * @Description: Description of this class

信息技术有限公司代码开发规范

xx信息技术有限公司代码开发规范 xx信息技术有限公司

代码开发规范 一、项目： IDE统一采用MyEclipse： 1.Tab policy设为“Spaces only”，Indentation size、Tab size均设为4 2.Maximum line width设为：140 3.java文件进行自动格式化 4.项目编码utf-8 二、代码： ?原则 1.数据结构应该只有公共变量；对象应该只有私有变量和公有函数； 2.一个类只做一类事、一个方法只做一件事 3.类、方法尽量简单、短小 4.宽度不超过140个字符 5.方法不超过40行，基本一屏高度 6.类不超过500行 7.尽量用好的命名代替注释 ?基本 1.统一采用log4j代替System.out.print、e.printStackTrace()等打印方式 2.流程语句必须用大括号 3.IO流必须用try finally关闭 ?命名 1.java基本命名规范 2.类为名词、属性为名词、方法为动词(+名词) 3.可以用2代替to，用4代替for，如string2int() 4.命名不许相互包含，如：get()，getOne()

5.不要采用getModel()、getModel1()、getModel2()数字方式命令 ?类型 1.对象属性必须为类，不能用String代替Number、Date等，不能使用基 本类型； 2.方法参数、返回均不许为Map（除非dao层） 3.泛型必须注明类型、不许使用List