程序员培训-Delphi编码规范.doc

《程序员培训-Delphi编码规范.doc》由会员上传分享，免费在线阅读，更多相关内容在应用文档-天天文库。

1、DELPHI编码规范福建星网视易信息系统有限公司更新记录：版本作者日期内容V1.0孙忠好2011-7-3编码规范初稿V1.1孙忠好211-07-29讨论会后的修改目录1.目的42.适用范围43.编码范规43.1.文件43.2.注释43.3.编码排版格式53.4.命名规范63.4.1.保留字63.4.2.过程和函数73.4.3.变量73.4.4.常量83.4.5.类83.4.6.控件83.5.修改规范113.5.1.新增代码行113.5.2.删除代码行113.5.3.修改代码行111.目的统一规范DELPHI的编码风格和标准。2.适用范围适用于所有用DELPHI语言开发的项目。3.编码范规

2、注：标有‘þ’的条目为强制检查项。3.1.文件1)þ项目文件必须使用一个有意义的名字并且以Prj打头。例如：Delphi中系统的项目文件被命名为’PrjSysInfo.dpr’。2)þunit文件使用‘Unit’作为前缀。例如：通常的unit被命名为’UnitGeneral’。3)þFormunit文件的名字必须和Form的名称保持一致。例如：主窗体叫frmMain则FormUnit文件的名字为’UnitfrmMain’。4)þDataModuleunit文件的名字必须和DataModule的名称保持一致。例如：主DataModule叫’DMMain’，则DataModuleUnit文件

3、的名字为’UnitDMMain’。5)þ公共单元统一命名为’UnitPublic.pas’。6)þ对于文件的目录要按如下结构来创建：-SQL（脚本文件目录）-DOC（文档目录）-Hlp（帮助文件目录）-SRC（源码文件目录）-PROJECT(项目工程文件目录)-BIN(EXE输出目录)-DCU（DCU输出目录）3.2.注释1)注释可以采用’{}’和’//’两种注释符号，但是涉及到多行注释时尽量使用’{}’。2)þ对于一行代码的注释可放在前一行及本行上，不允许放在下一行，更不允许在一行语句的中间加入注释。3)þ单元文件的文件头注释说明应按如下格式：{********************

4、**********************************************}{}{Copyright(c)2008-2011福建星网视易信息系统有限公司}{}{******************************************************************}unitUnitfrmCustomer;{*=================================================================*系统名称：精通管理系统*单元名称：会员信息维护*单元作者：xxxx*功能描述：主要是进行会员信息的增加修改

5、和删除以会员信息的写卡和刷卡操作。*修改记录：*李明2010-07-01创建该单元ß仅记录功能修改,bug修改不记录*张山2011-08-02会员查询增加按会员卡号查询的条件}1)þ不必每行都加注释，在3～10行左右的段落做注释要好于每行都做注释，显而易见的代码不加注释。例如：if(ErrorCode<>0)then//执行过程失败ß无用的注释beginShowMessage(‘保存员工信息失败!’);end;1.1.编码排版格式1)þ代码的缩进应使用空格（SPACE），不能使用制表符(TAB)，并且缩进以2字符为单位。2)þbegin语句和end语句在源程序中要独占一行。例如://不正

6、确的用法fori:=0to10dobeginend;//正确的用法fori:=0to10dobeginend;3)þ空格的使用:a)关键字与其后的表达式之间要有空格，如:if(expr)或while(expr)b)单目操作符不应与它们的操作数分开（如’@’和’^’）。c)除’.’外，其它双目操作符应与它们的操作数用空格隔开。例如:i:=i+1;//错误的写法，操作符两端没有空格i:=i+1;//正确的写法if(a>b)then//错误的用法，逻辑判断符号两端没有空格if(a>b)then//正确的用法1)þ每行只能有一个语句。例如://不正确写法a:=a+1;sum:=sum+a;//正

7、确写法:a:=a+1;sum:=sum+a;2)þ一个过程或函数结束后，后续语句要隔一空行。例如:procedureGetMax():Integerbegin…result:=MaxValue;end;<<一个过程或函数结束后,后续语句要隔一空行procedureGetMin():Integerbegin…result:=MinValue;end;3)每行的代码不允许超出一个屏幕的宽度。1.1.命名规范1.1.1.保留字þObjec