公司编码规范

格式：doc
大小：141.50 KB
文档页数：17

公司编码规范目录第一部分概述 (3)1.1规范制定原则 (3)1.2术语定义 (3)1.2.1Pascal 大小写 (3)1.2.2Camel 大小写 (3)第二部分程序版式 (3)2.1列宽 (3)2.2换行 (3)2.3空行 (3)2.4空格 (4)2.5括号- () (4)2.6花括号- {} (5)2.7注释 (6)2.7.1概述 (6)2.7.2注释的使用 (6)第三部分命名规则 (7)3.1共用部分 (7)3.2C++部分 (8)3.3C#部分 (9)第四部分语句规则 (14)4.1共用部分 (14)4.2C++部分 (14)4.2.1常量 (14)4.2.2if 语句 (14)4.2.2.1布尔变量与零值比较 (14)4.2.2.2整型变量与零值比较 (15)4.2.2.3浮点变量与零值比较 (15)4.2.2.4指针变量与零值比较 (15)4.2.2.5对if语句的补充说明 (15)4.2.3函数 (16)第五部分匈牙利命名法 (16)第一部分概述1.1 规范制定原则1 方便代码的交流和维护。

2 不影响编码的效率，不与大众习惯冲突。

3 使代码更美观、阅读更方便。

4 使代码的逻辑更清晰、更易于理解。

1.2 术语定义1.2.1 Pascal 大小写将标识符的首字母和后面连接的每个单词的首字母都大写。

可以对三字符或更多字符的标识符使用Pascal 大小写。

例如：BackColor1.2.2 Camel 大小写标识符的首字母小写，而每个后面连接的单词的首字母都大写。

例如：backColor第二部分程序版式2.1 列宽代码列宽控制在110字符左右。

2.2 换行当表达式超出或即将超出规定的列宽，遵循以下规则进行换行：1、在逗号后换行。

2、在操作符前换行。

3、规则1优先于规则2。

当以上规则会导致代码混乱的时候自己采取更灵活的换行规则。

2.3 空行空行是为了将逻辑上相关联的代码分块，以便提高代码的可阅读性。

在以下情况下使用两个空行：1、接口和类的定义之间。

2、枚举和类的定义之间。

3、类与类的定义之间。

在以下情况下使用一个空行：1、方法与方法、属性与属性之间。

2、方法中变量声明与语句之间。

3、方法与方法之间。

4、方法中不同的逻辑块之间。

5、方法中的返回语句与其他的语句之间。

6、属性与方法、属性与字段、方法与字段之间。

7、注释与它注释的语句间不空行，但与其他的语句间空一行。

2.4 空格在以下情况中要使用到空格：1、关键字和左括符“(”应该用空格隔开。

如：while ( true )注意在方法名和左括符“(”之间不要使用空格，这样有助于辨认代码中的方法调用与关键字。

2、多个参数用逗号隔开，每个逗号后都应加一个空格。

3、除了 . 之外，所有的二元操作符都应用空格与它们的操作数隔开。

一元操作符、++及--与操作数间不需要空格。

如A += c + d;A = ( a + b ) / ( c * d );while ( d ++ = s ++ ){n++;}P rintSize(“size is “ + size + “\n”);4、语句中的表达式之间用空格隔开。

如for (expr1; expr2; expr3)2.5 括号- ()1、左括号“(”不要紧靠关键字，中间用一个空格隔开。

2、左括号“(”与方法名之间不要添加任何空格。

3、没有必要的话不要在返回语句中使用()。

如：if ( condition )Array.Remove(1)return 1;2.6 花括号- {}1、左花括号“{”放于关键字或方法名的下一行并与之对齐。

如：if (condition){}public int Add(int x, int y){}2、左花括号“{”要与相应的右花括号“}”对齐。

3、通常情况下左花括号“{”单独成行，不与任何语句并列一行。

4、if、while、do语句后一定要使用{}，即使{}号中为空或只有一条语句。

如：if (somevalue == 1){somevalue = 2;}5、右花括号“}”后建议加一个注释以便于方便的找到与之相应的 {。

如：while (1){if (valid){} // if validelse{} // not valid} // end forever2.7 注释2.7.1 概述1、修改代码时，总是使代码周围的注释保持最新。

2、在每个例程的开始，提供标准的注释样本以指示例程的用途、假设和限制很有帮助。

注释样本应该是解释它为什么存在和可以做什么的简短介绍.3、避免在代码行的末尾添加注释；行尾注释使代码更难阅读。

不过在批注变量声明时，行尾注释是合适的；在这种情况下，将所有行尾注释在公共制表位处对齐。

4、在部署发布之前，移除所有临时或无关的注释，以避免在日后的维护工作中产生混乱。

5、如果需要用注释来解释复杂的代码节，请检查此代码以确定是否应该重写它。

尽一切可能不注释难以理解的代码，而应该重写它。

尽管一般不应该为了使代码更简单以便于人们使用而牺牲性能，但必须保持性能和可维护性之间的平衡。

6、在编写注释时使用完整的句子。

注释应该阐明代码，而不应该增加多义性。

7、在编写代码时就注释，因为以后很可能没有时间这样做。

另外，如果有机会复查已编写的代码，在今天看来很明显的东西六周以后或许就不明显了。

8、避免多余的或不适当的注释，如幽默的不主要的备注。

9、使用注释来解释代码的意图。

它们不应作为代码的联机翻译。

10、注释代码中不十分明显的任何内容。

11、为了防止问题反复出现，对错误修复和解决方法代码总是使用注释，尤其是在团队环境中。

12、对由循环和逻辑分支组成的代码使用注释。

这些是帮助源代码读者的主要方面。

13、在整个应用程序中，使用具有一致的标点和结构的统一样式来构造注释。

14、用空白将注释同注释分隔符分开。

在没有颜色提示的情况下查看注释时，这样做会使注释很明显且容易被找到。

15、在所有的代码修改处加上修改标识的注释。

16、为了是层次清晰，在闭合的右花括号后注释该闭合所对应的起点。

（4）如果代码本来就是清楚的，则不必加注释。

否则多此一举，令人厌烦。

如： i++; // i 加 1，多余的注释注释例子：第三部分命名规则3.1 共用部分本节论述的共性规则是被大多数程序员采纳的。

1、标识符应当直观且可以拼读，可望文知意，不必进行“解码”。

标识符最好采用英文单词或其组合，便于记忆和阅读。

切忌使用汉语拼音来命名。

程序中的英文单词一般不会太复杂，用词应当准确。

例如不要把CurrentValue写成NowValue。

2、标识符的长度应当符合言简意赅的原则。

例如变量名maxval就比maxValueUntilOverflow好用。

单字符的名字也是有用的，常见的如i,j,k,m,n,x,y,z等，它们通常可用作函数内的局部变量。

3、命名规则尽量与所采用的操作系统或开发工具的风格保持一致。

例如Windows应用程序的标识符通常采用“大小写”混排的方式，如AddChild。

而Unix 应用程序的标识符通常采用“小写加下划线”的方式，如add_child。

别把这两类风格混在一起用。

4、程序中不要出现仅靠大小写区分的相似的标识符。

例如：int x, X; // 变量x 与 X 容易混淆void foo(int x); // 函数foo 与FOO容易混淆void FOO(float x);5、程序中不要出现标识符完全相同的局部变量和全局变量，尽管两者的作用域不同而不会发生语法错误，但会使人误解。

6、变量的名字应当使用“名词”或者“形容词＋名词”。

例如：float value;float oldValue;float newValue;7、全局函数的名字应当使用“动词”或者“动词＋名词”（动宾词组）。

类的成员函数应当只使用“动词”，被省略掉的名词就是对象本身。

例如：DrawBox(); // 全局函数box->Draw(); // 类的成员函数8、用正确的反义词组命名具有互斥意义的变量或相反动作的函数等。

例如：int minValue;int maxValue;int SetValue(…);int GetValue(…);9、尽量避免名字中出现数字编号，如Value1,Value2等，除非逻辑上的确需要编号。

10、常量全用大写的字母，用下划线分割单词。

例如：const int MAX = 100;const int MAX_LENGTH = 100;3.2 C++部分1、类名、函数名、属性名、方法名、事件名采用Pascal命名法。

例如：class Node; // 类名class LeafNode; // 类名void Draw(void); // 函数名void SetValue(int value); // 函数名2、函数或方法内的变量采用Camel命名法，并采用数据类型作为变量前缀。

例如：BOOL blnFlag;int intDrawMode;3、静态变量加前缀s_（表示static）。

例如：void Init(…){static int s_initValue; // 静态变量…}4、如果不得已需要全局变量，则使全局变量加前缀g_（表示global）。

例如：int g_howManyPeople; // 全局变量int g_howMuchMoney; // 全局变量3.3 C#部分1、命名空间●命名命名空间时的一般性规则是使用公司名称，后跟技术名称和可选的功能与设计，如下所示。

CompanyName.TechnologyName[.Feature][.Design]例如：namespace Sine.Procurement // 采购单管理系统namespace Sine.Procurement.DataRules // 采购单管理系统的业务规则模块●命名空间使用Pascal大小写，用逗号分隔开。

●TechnologyName 指的是该项目的英文缩写，或软件名。

●命名空间和类不能使用同样的名字。

例如，有一个类被命名为Debug后，就不要再使用Debug作为一个名称空间名。

2、类与接口●使用 Pascal 大小写。

●使用全称避免缩写，除非缩写已是一种公认的约定，如URL、HTML●不要使用类型前缀，如在类名称上对类使用 C 前缀。

例如，使用类名称FileStream，而不是CFileStream。

●不要使用下划线字符 (_)。

●接口以字母 I 开始的类名称。

公司物料编码管理制度

公司物料编码管理制度第一章总则第一条为规范公司物料编码管理工作，提高物料管理的效率和精度，制定本制度。

第二条本制度适用于公司所有部门和员工，包括各类物料的编码、管理和使用。

第三条公司物料编码是指为公司所有物料进行唯一标识的一种方式，用来识别物料的种类、规格、数量等信息。

第四条公司物料编码管理制度的宗旨是规范、统一、有效地管理公司所有物料编码，确保物料管理工作的准确性和高效性。

第五条公司物料编码管理制度的原则是科学性、规范性、实用性、灵活性和可行性。

第六条公司物料编码管理制度的内容包括物料编码的规范、编码方法、编码管理、编码修改、编码查询、编码使用等方面的规定。

第七条公司物料编码管理制度的执行由公司物料管理部门负责，各部门配合执行。

第八条公司物料编码管理制度的修订由公司物料管理部门组织，并报公司领导审批。

第二章物料编码的规范第九条公司物料编码的规范是指制定一套统一的编码规则和标准，确保物料编码的唯一性和规范性。

第十条公司物料编码的规范包括以下几个方面：（一）物料编码应具有唯一性，不得重复使用。

（二）物料编码应包含物料的种类、规格、数量等信息。

（三）物料编码应遵循一定的规则和标准，便于管理和识别。

（四）物料编码应与公司的ERP系统相适配，实现信息的共享和交换。

第十一条公司物料编码的构成应包括以下几个要素：（一）物料种类：用数字或字母表示物料的种类，如：原材料、半成品、成品等。

（二）规格型号：用数字或字母表示物料的规格和型号，以便区分不同物料。

（三）数量单位：用数字或字母表示物料的数量单位，如：个、箱、件等。

（四）其他信息：根据需要可以添加其他信息，如：生产日期、过期日期等。

第十二条公司物料编码的长度应根据物料的种类、规格和数量来确定，一般不得小于10位。

第十三条公司物料编码的命名应具有易记性、规范性和统一性，不得混淆。

第三章物料编码的管理第十四条公司物料编码管理工作包括编码的申请、分配、维护和监督等方面。

公司编码管理制度

第一章总则第一条为规范公司内部档案管理，提高档案工作效率，确保档案资料的安全、完整和有效利用，特制定本制度。

第二条本制度适用于公司内部所有档案资料的编码、归档、保管、借阅、销毁等环节。

第三条公司档案编码管理应遵循统一、科学、系统、便捷的原则。

第二章分类与编码第四条公司档案按照以下十大类进行分类：1. 基础建设类2. 经营管理类3. 党群类4. 人事类5. 科学研究类6. 设备仪器类7. 会计类8. 行政类9. 其他类10. 特殊档案类第五条特殊且数量较大的档案可独立分一个大类，如：专利档案、合同档案等。

第六条档案编码采用字母与数字相结合的方式，具体编码规则如下：1. 第一位字母代表档案类别；2. 第二位字母代表档案来源部门；3. 第三位至第五位数字代表档案序号；4. 第六位数字代表档案年度；5. 第七位至第九位数字代表档案文件页数。

第三章归档与保管第七条档案资料归档前，应进行整理、分类、编码，确保档案资料完整、准确。

第八条归档的档案资料应按照类别、来源部门、年度等进行排列，便于查阅和管理。

第九条档案资料应妥善保管，确保档案实体安全。

具体保管要求如下：1. 档案资料应存放在通风、干燥、防火、防盗、防潮、防虫蛀的专用档案柜中；2. 档案柜应定期检查、清洁，确保档案资料安全；3. 档案资料应按照编号顺序存放，便于查阅。

第四章借阅与利用第十条公司内部员工因工作需要借阅档案资料，应向档案管理部门提出申请，经批准后方可借阅。

第十一条借阅档案资料时，应填写借阅单，注明借阅目的、借阅时间、归还时间等。

第十二条借阅的档案资料应在规定时间内归还，如需延长借阅时间，应提前向档案管理部门申请。

第十三条档案管理部门应定期对借阅情况进行统计，确保档案资料的有效利用。

第五章销毁与报废第十四条档案资料达到销毁条件时，应由档案管理部门提出销毁意见，经公司领导批准后进行销毁。

第十五条销毁档案资料时，应按照国家有关规定和档案资料的性质进行分类、打包、封存，并做好销毁记录。

生产型公司文件编码规范

生产型公司文件编码规范1. 引言本文档旨在为生产型公司制定文件编码规范，以确保文件的统一性、便捷性和可管理性。

规范化的文件编码将有助于提高工作效率和减少错误。

2. 编码规则在制定文件编码时，请遵循以下规则：2.1 文件编码结构文件编码应由多个部分组成，包括项目标识、日期标识和文档类型标识。

各部分之间可使用分隔符进行分割。

- 项目标识：代表文件所属的项目或任务。

可以采用特定的编号、名称或代号。

- 日期标识：代表文件创建或更新的日期。

格式应为YYYYMMDD，如。

- 文档类型标识：代表文件的类型或类别。

可以根据实际需要自定义。

例如，一个文件编码的结构可以是：项目标识-日期标识-文档类型标识，如：PRJ001--DOC001。

2.2 编码命名规范在编码文件时，请遵循以下规范：- 使用大写字母和数字进行编码，避免使用特殊字符。

- 不要使用含糊不清或重复的命名。

命名应简明扼要、清晰易懂。

- 如果文件名称过长，可适当缩写或使用简称。

2.3 特殊情况处理对于特殊情况，可以制定额外的编码规则。

例如，会议纪要可以在文件编码中添加会议编号，以便与其他文件区分。

3. 示例以下是一些示例文件编码的例子，仅供参考：- PRJ001--DOC001：代表项目001在2022年1月1日创建的文档001。

- PRJ002--REPORT001：代表项目002在2022年1月15日创建的报告001。

4. 实施与管理为了保证文件编码规范的实施和管理，可以采取以下措施：- 向所有员工提供编码规范的培训，并明确其重要性和作用。

- 在文件管理系统中设置自动编码功能，以确保文件编码的一致性。

- 定期审查文件编码的使用情况，并根据需要进行调整和改进。

5. 结论本文档所制定的生产型公司文件编码规范将有助于提高文件管理的效率和可追溯性。

遵循规范的编码将减少错误和混淆，方便员工查找和使用文件。

以上是对生产型公司文件编码规范的简要说明，希望能为公司的文件管理提供一些指导和参考。