软件行业研发部程序员代码开发规范手册（执行版）.docxVIP

软件行业研发部程序员代码开发规范手册（执行版）

软件行业研发部程序员代码开发规范手册（执行版）

第1章代码基础规范

1.1命名规则与风格

在软件工程的基石中，命名是程序员与机器沟通的第一语言，它直接决定了代码的可维护性、可测试性以及团队协作的效率。遵循统一的命名规范，能够消除歧义，降低认知负荷，确保所有成员在同一套“语言”下工作。常量命名必须采用UPPER_SNAKE_CASE格式（全大写，下划线分隔），如`MAX_RETRY_COUNT`或`API_TIMEOUT_SECONDS`。常量代表系统内不可变的业务参数或物理极限值，一旦定义后严禁修改，且命名需直观表达其业务含义，避免使用`CONST_001`等无意义的编号命名。

函数名必须严格遵循snake_case命名规范，即全小写，单词之间用下划线连接（例如：`calculateTotalPrice`,`validateUserCredentials`）。函数名需准确反映其功能职责，避免使用动词名词化（如将`get`改为`Get`）或过度抽象（如将`processData`改为`process`），确保函数名作为动词短语清晰表达操作意图。类名（Class）必须使用PascalCase命名（例如：`UserService`,`OrderProcessor`），以区别于普通变量