软件工程技术部程序员代码编写规范手册.docxVIP

软件工程技术部程序员代码编写规范手册

第1章项目结构与组织规范

1.1项目根目录目录结构

项目根目录（RootDirectory）必须严格遵循`src/`与`test/`的层级划分，这是代码组织的基础，确保开发、测试与生产环境分离。在`src/`目录下，根据模块划分子文件夹（如`user-service/`,`order-service/`），每个子文件夹应包含对应的`package.json`和`pom.xml`配置文件，明确声明语言版本、依赖库及构建工具版本。

每个Java/SpringBoot模块必须定义`perties`或`application.yml`配置文件，其中必须包含`server.port`端口号、`files.active`环境标识（如`dev`、`prod`）以及数据库连接字符串。子模块内部应保持单一职责原则，所有业务逻辑代码必须位于`src/main/java`文件夹下，而所有单元测试代码必须位于`src/test/java`文件夹下，严禁混用。所有外部依赖（如SpringBoot框架、MyBatisMapper、Redis客户端）的引入必须在`pom.xml`或`build.gradle`中通过`dependency`或`implementation`标签