PB从入坑到放弃(二)编码规范

发布网友 发布时间：2024-10-23 23:46

我来回答

共1个回答

热心网友 时间：18小时前

上篇内容介绍了如何利用PowerBuilder开发并打包一个简单的Helloworld程序，以及如何成功创建安装包。本篇将重点探讨编程规范，以提升代码质量和团队协作效率。

在编程世界中，编写清晰文档和注释的重要性不容忽视。试想在寻找bug时，面对一段令人困惑的代码，内心不禁暗骂：“是谁写的这段代码？”答案往往是自己。无规矩不成方圆，团队合作的代码编写亦需遵循一定的规范，以保证代码的优雅性和可维护性。

### 变量命名规范

变量命名应简洁、直观，包含类型、范围、含义，并通过注释明确描述。例如：

pb
string myName // 姓名变量

### 应用命名规范

应用名应与功能紧密相关，使用英文描述，如`app_hospital`表示医院管理应用。

### PB库命名规范

库组织应清晰、有序，数量适度，分类合理，以提高开发和维护效率。库名应与功能关联，如`report.pbl`表示报表库。

### 窗口命名规范

窗口名应简洁，总长度不超过40个字符，与窗口功能相关联。如`w_login`表示登录窗口。

### 数据窗口命名规范

数据窗口命名应结合功能描述，区分普通和下拉式，例如`dw_customer`表示客户数据窗口。

### 用户对象命名

遵循简洁、明确的命名规则，如`uo_login`表示登录用户对象。

### 常用控件命名

控件命名结合功能描述，例如`cb_login`表示登录按钮。

### 函数命名规范

函数命名包含类型、功能描述，如`f_loginCheck`表示登录检查函数。

### 注释规范

注释需明确、位置恰当，包括窗口open事件、脚本、变量等。如窗口注释：

pb
on open
// 初始化窗口元素
w_loginTitle.text = "登录窗口";
// 其他初始化代码

### 代码编写规范

代码应层次清晰，缩进规范，如使用分层缩进展示嵌套结构。避免使用goto跳转，如需使用需详细注释。游标和存储过程命名遵循特定规则。

### 控件使用规范

不同控件遵循特定命名规则，如静态文本框、单行编辑框、命令按钮等，外观和功能说明明确。

### 错误处理

错误处理标准化，确保代码对错误原因和数据库错误的明确说明。

### 版本控制

遵循版本号标准，定义开发、测试、稳定等不同阶段的版本，以及版本升级规则。

### 结论

本篇从变量命名、代码编写、注释、错误处理等方面详细阐述了在使用PowerBuilder开发时应遵循的规范，以提升代码质量和团队协作效率。团队可根据自身需求调整这些规范，以适应特定项目需求。