📄 delphi 程序员代码编写标准指南.htm
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- saved from url=(0050)file://\\W2\Share\Documents\DelphiCodeStandard.htm -->
<HTML><HEAD><TITLE>New Page 1</TITLE>
<META http-equiv=Content-Type content="text/html; charset=gb2312">
<META content="MSHTML 6.00.3790.0" name=GENERATOR>
<META content=FrontPage.Editor.Document name=ProgId></HEAD>
<BODY>
<TABLE cellSpacing=0 cellPadding=0 width=778 align=center border=0>
<TBODY>
<TR>
<TD vAlign=top align=left width=675>
<DIV align=center><FONT size=+1><B><BR>Delphi
程序员代码编写标准指南</B></FONT><BR><BR>[ 翻译作者: 不详 ]<BR><BR></DIV><BR><FONT
style="FONT-SIZE: 11pt; LINE-HEIGHT: 16pt">一、序言<BR><BR>二、通用源代码格式规则<BR><BR>2.1
缩格<BR><BR>2.2 页边空格<BR><BR>2.3 Begin…End 配对<BR><BR>三、Object Pascal<BR>3.1
括号<BR><BR>3.2 保留字和关键字<BR><BR>3.3 过程和函数（例程）<BR><BR> 3.3.1
命名/格式化<BR><BR> 3.3.2 形式参数<BR><BR>
3.3.2.1 格式化<BR><BR> 3.3.2.2
命名<BR><BR> 3.3.2.3 参数的排序<BR><BR>
3.3.2.4 常量参数<BR><BR> 3.3.2.5
名称的冲突<BR><BR>3.4 变量<BR><BR> 3.4.1 变量的命名和格式<BR><BR>
3.4.2 局部变量<BR><BR> 3.4.3 全局变量的使用<BR><BR>3.5
类型<BR><BR> 3.5.1 大写约定<BR><BR>
3.5.1.1 浮点指针类型<BR><BR> 3.5.1.2
枚举类型<BR><BR> 3.5.1.3 变数和ole变数类型<BR><BR>
3.5.2 结构类型<BR><BR> 3.5.2.1
数组类型<BR><BR> 3.5.2.2 记录类型<BR><BR>3.6
语句<BR><BR> 3.6.1 if 语句<BR><BR> 3.6.2 case
语句<BR><BR> 3.6.2.1 一般性话题<BR><BR>
3.6.2.2 格式<BR><BR> 3.6.3 while 语句<BR><BR>
3.6.4 for 语句<BR><BR> 3.6.5 repeat 语句<BR><BR>
3.6.6 with 语句<BR><BR> 3.6.6.1
一般话题<BR><BR> 3.6.6.2 格式<BR><BR>3.7
结构异常处理<BR><BR> 3.7.1 一般话题<BR><BR> 3.7.2
try…finally的使用<BR><BR> 3.7.3 try…except的使用<BR><BR>
3.7.4 try…except…else的使用<BR><BR>3.8 类类型<BR><BR> 3.8.1
命名和格式<BR><BR> 3.8.2 域<BR><BR>
3.8.2.1 命名/格式<BR><BR> 3.8.2.2
可视化<BR><BR> 3.8.3 方法<BR><BR> 3.8.3.1
命名/格式<BR><BR> 3.8.3.2 使用静态的方法<BR><BR>
3.8.3.3 使用虚拟/动态的方法<BR><BR>
3.8.3.4 使用抽象的方法<BR><BR> 3.8.3.5
属性存取方法<BR><BR> 3.8.4 属性<BR><BR>
3.8.4.1 命名/格式<BR><BR> 3.8.4.2
使用存取的方法<BR><BR>四、文件<BR><BR>4.1 工程文件<BR><BR> 4.1.1
命名<BR><BR>4.2 窗体文件<BR><BR> 4.2.1 命名<BR><BR>4.3
数据模板文件<BR><BR> 4.3.1 命名<BR><BR>4.4 远端数据模板文件<BR><BR>
4.4.1 命名<BR><BR>4.5 Unit文件<BR><BR> 4.5.1
通用Unit结构<BR><BR> 4.5.1.1 unit的名字<BR><BR>
4.5.1.2 uses子句<BR><BR>
4.5.1.3 interface部分<BR><BR> 4.5.1.4
implementation部分<BR><BR> 4.5.1.5
initialization部分<BR><BR> 4.5.1.6
finalization部分<BR><BR> 4.5.2 窗体单元<BR><BR>
4.5.2.1 命名<BR><BR> 4.5.3 数据模板单元<BR><BR>
4.5.3.1 命名<BR><BR> 4.5.4 一般目的单元<BR><BR>
4.5.4.1 命名<BR><BR> 4.5.5
构件单元<BR><BR> 4.5.5.1 命名<BR><BR>4.6
文件头<BR><BR>五、窗体和数据模板<BR><BR>5.1 窗体<BR><BR> 5.1.1
窗体类型命名标准<BR><BR> 5.1.2 窗体实例命名标准<BR><BR> 5.1.3
自动创建窗体<BR><BR> 5.1.4 模式窗体实例化函数<BR><BR>5.2 数据模板<BR><BR>
5.2.1 数据模板命名标准<BR><BR> 5.2.2
数据模板实例命名标准<BR><BR>六、包<BR><BR>6.1 使用运行包和设计包的比较<BR><BR>6.2
文件命名标准<BR><BR>七、构件<BR><BR>7.1 用户自定义构件<BR><BR>7.2 构件单元<BR><BR>7.3
使用注册单元<BR><BR>7.4 构件实例命名约定<BR><BR>7.5 构件的前缀<BR><BR>7.6
Standard页<BR><BR>7.7 Additional页<BR><BR>7.8 Win32页<BR><BR>7.9
System页<BR><BR>7.10 Internet页<BR><BR>7.11 Data Access页<BR><BR>7.12 Data
Controls页<BR><BR>7.13 Decision Cube页<BR><BR>7.14 QReport页<BR><BR>7.15
Dialogs页<BR><BR>7.16 Win3.1页<BR><BR>7.17 Samples页<BR><BR>7.18
ActiveX页<BR><BR>7.19 Midas页<BR><BR>一、序言<BR><BR><BR><BR>本文档详述了在Delphi
4开发者指南下进行编程的代码编写标准。在通常情况下，本文档遵循“取消”式格式的指引方针，该方针由Borland国际通过一些例外来使用。在Delphi
4开发者指南中包含本文档的目的在于阐述一种方法，通过该方法，开发小组可以在他们所编写的代码中保持一贯的风格。这样做的目的是使在开发小组中的每一个程序员都可以明白其他程序员的代码。这有助于提高代码编写的可读性和使用的一贯性。<BR><BR><BR><BR>本文档并不意味着包含了所有存在于代码中的标准。但是，它的内容已足够帮你起个好头。你可以自由的增加修改这些标准来满足你的需要。我们不赞成你偏离这些由Borland开发人员所使用的标准太远。我们推荐这么做是因为一旦有新的程序员加入到你的开发小组中，而他们最喜欢和最熟悉的是Borland的标准。象大多数代码标准文档，本文档也会根据需要进行改动。因此，你可以到www.xapware.com/ddg中找到最新的更新版本。本文档不包括用户接口标准。本文档是独立的但也是同样重要的。已经有足够的第三方书籍和Microsoft文档包括了另外一些指导方针，而我们决定并不复制这些信息，但我们会指引你到Microsoft
Developers Network
和一些资源，在那儿可以找到你所需的信息。<BR><BR><BR><BR>二、通用源代码格式规则<BR><BR><BR><BR>2.1
缩格<BR><BR><BR><BR>缩格是指在每一级有两个空格。不要在源代码中保留tab字符，这是因为tab字符会随着不同用户的不同设置和不同的资源管理工具（打印、文档、版本控制等）而代表不同的宽度。<BR><BR><BR><BR>你可以通过关闭Environment选项对话框中Editor页上的“Use
tab character”和“Optimal
fill”检查框（通过Tools|Environment）来禁止保存tab字符。<BR><BR><BR><BR>2.2
页边空格<BR><BR><BR><BR>页边空格会被设置成80字符宽。通常，源码不会超出这个边界，但这个方针会有一些弹性。不管是否有可能，那些超出到另一行的语句会在一个逗号或其他操作符之后与前面的语句相连。当一个语句被打断相连时，它应比原来的那一行语句缩进两个字符。<BR><BR><BR><BR>2.3
Begin…End 配对<BR><BR><BR><BR>Begin
子句应写在独立的一行。例如，下面第一行是错误的写法而第二行是正确的。<BR><BR>for I := 0 to 10 do begin
//错误，begin同for在同一行<BR><BR>for I := 0 to 10 do
//正确，begin出现在独立的一行<BR><BR>begin<BR><BR><BR><BR>这个规则的例外是当begin子句的出现是作为一个else子句的一部分－参考例子：<BR><BR>if
some statement then<BR><BR>begin<BR><BR> …<BR><BR>end<BR><BR>else
begin<BR><BR> someOtherStatement;<BR><BR>end;<BR><BR><BR><BR>end
语句永远出现在独立的一行。<BR><BR>当begin语句不是一个else子句的一部分时，相应的end语句永远缩进到与begin部分相对应的位置。<BR><BR><BR><BR>三、Object
Pascal<BR><BR><BR><BR>3.1
括号<BR><BR><BR><BR>永远不要在括号与括号之间的字符中间留下空格。下面的例子示范了错误的与正确地使用括号中的空格：<BR><BR>
CallProc( Aparameter );
//错误<BR><BR> CallProc(Aparameter);
//正确<BR><BR><BR><BR>永远不要在一个语句中使用不必要的括号。括号只应在源代码中需要的地方使用。以下的例子示范了错误和正确的使用：<BR><BR>if
(I = 42) then
//错误 － 多余的括号<BR><BR>if (I = 42) or (J = 42) then
//正确－ 需要括号<BR><BR><BR><BR>3.2
保留字和关键字<BR><BR><BR><BR>Object Pascal 保留字和关键字永远是全部小写。</FONT> <BR><BR>
<DIV align=center><FONT size=+1><B><BR>Delphi
程序员代码编写标准指南(2)</B></FONT><BR><BR>[ 作者: 不详 添加时间: 2001-7-20 8:15:22
]<BR><BR></DIV>
<TABLE cellSpacing=0 cellPadding=0 width=675 border=0>
<TBODY>
<TR>
<TD width=595 background="" height=3></TD></TR></TBODY></TABLE><BR><FONT
style="FONT-SIZE: 11pt; LINE-HEIGHT: 16pt"><BR><BR><BR>3.3
过程和函数（例程）<BR><BR><BR><BR>3.3.1
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -