软件开发行业技术部程序员代码规范手册.docxVIP

软件开发行业技术部程序员代码规范手册

第一章项目结构与组织

1.1根目录规范与核心模块划分

在大型软件开发团队中，清晰的根目录结构是团队协作的基石，它直接决定了代码的可读性、维护效率以及版本控制系统的运行状态。根目录（通常位于项目根文件夹）不应包含任何业务逻辑代码，仅作为所有模块的入口点，并集中存放全局配置、构建脚本及核心架构文件。

根目录下应严格禁止放置任何`.java`、`.py`、`.go`等文件，所有业务代码必须位于子目录中，通过`package`声明进行隔离。根目录下的`pom.xml`(Maven)或`build.gradle`(Gradle)文件必须位于最顶层，且版本号需与项目整体依赖策略保持一致，避免手动修改导致构建冲突。

根目录下的`src/main/resources`或`src/test/resources`是存放配置文件的标准位置，需将`perties`或`application.yml`置于该目录下，确保环境变量读取逻辑正确。根目录下的`src/main/java`或`src/test/java`应明确划分为`ject`等包结构，遵循单一职责原则，避免包名过长或嵌套过深。根目录下的`src/test/java`中应包含`Test`包，用于编写单元测试，该包下的类需继承自`TestC