软件行业技术部程序员软件编码规范手册（执行版）.docxVIP

软件行业技术部程序员软件编码规范手册（执行版）

第一章代码编写规范

1.1命名规则与风格

1.1命名规则与风格

在软件工程中，代码命名是程序员与机器沟通的第一道门槛，直接决定了代码的可维护性、可读性及团队协作效率。本规范严格遵循“单一职责原则”和“开闭原则”，通过严格的命名约定，确保代码结构清晰、意图明确。

遵循小驼峰命名法（CamelCase），即使用单个大写字母或下划线分隔的单词序列，例如`userProfile`或`user_profile`。当单词首字母大写表示新词类时，必须使用下划线连接（如`user_profile`），避免歧义。所有类名（Class）、方法名（Method）和函数名（Function）必须全部使用小写开头，并配合下划线分隔，例如`calculateTotalPrice`或`calculate_total_price`。

常量名（Constant）必须全部使用大写字母，且首字母大写，例如`MAX_RETRY_COUNT`或`API_TIMEOUT`，以区别于普通变量。模块名（Module）、包名（Package）或文件名的首字母必须大写，例如`UserService`、`OrderService`或`main.py`，以便于目录管理和文件识别。私有成员（如类内部的变量或方法）必须加上`private`、`p