软件开发行业技术部开发工程师代码编写规范手册（执行版）.docxVIP

软件开发行业技术部开发工程师代码编写规范手册（执行版）

第1章项目架构与目录结构规范

1.1项目根目录层级划分规则

项目根目录（ProjectRoot）应严格遵循“单一职责”原则，仅存放项目入口文件（如`main.py`或`index.js`）及全局配置文件（如`docker-compose.yml`、`requirements.txt`或`package.json`），严禁在此目录中放置任何业务代码、测试代码或第三方依赖包，以确保持久性可维护性。根目录下的`.gitignore`文件必须精确匹配本项目特有的忽略规则，例如明确排除`__pycache__`、`.pyc`、`.venv/`及`.idea/`等临时文件，同时保留`Dockerfile`和`docker-compose.yml`等构建所需的配置文件，确保开发、测试与生产环境能自动隔离。

根目录下应建立统一的版本控制子目录`version`，用于存放项目版本号（如`version-1.0.0`）及对应的构建产物（如`dist/`或`build/`），通过版本号关联不同分支的代码，防止版本混淆。根目录需设置严格的权限控制机制，禁止非核心开发人员直接修改根目录下的核心逻辑文件，所有代码变更必须通过Git提交流程进行版本管理，任何对根目录结构的修改均需经过团队审批。