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

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

第1章项目结构与版本管理

1.1项目根目录规范

在软件研发体系中，项目根目录（ProjectRootDirectory）是代码、资源、配置和构建系统的“中枢神经”，任何文件的放置位置都必须严格遵循此规范，以确保团队协作的标准化与可维护性。

所有文件必须放置在`src/`目录下，该目录位于项目根目录的`src/`文件夹内，严禁将`.java`或`.py`等文件放置在`main/`、`lib/`或其他非源文件目录下，这是为了方便IDE自动导入和统一代码风格。所有配置文件（如`perties`、`pom.xml`、`docker-compose.yml`等）必须放置在`src/main/resources/`目录下，这样构建工具（如Maven或Gradle）在打包时才能自动读取这些文件，避免运行时找不到配置项导致的错误。

测试代码（Test目录）和单元测试文件（如`test/java/`或`test/python/`）必须放置在`src/test/`目录下，且测试代码不应直接暴露给生产环境，必须通过单元测试框架独立运行，以确保代码质量。配置文件中的敏感信息（如数据库密码、API密钥）必须在代码中通过环境变量注入（如`System.getenv()`或`Valu