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

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

第1章项目结构与工程部署

1.1项目根目录规范与分支策略

项目根目录（ProjectRoot）是代码仓库的入口点，必须严格遵循“单一提交（SingleCommit）”原则，禁止在此目录中放置与业务逻辑无关的临时文件、配置文件或调试代码。根目录下应仅包含`package.json`（Node.js）或`pom.xml`（Java）等配置文件，以及`README.md`（项目说明文档），并明确列出所有依赖包版本（如`lodash4.17.21`），确保环境可复现。

严禁将`.gitignore`文件直接放在根目录中，应将其放置在`package.json`同级目录下，明确列出`node_modules`、`.DS_Store`、`__pycache__`等需要自动忽略的目录。分支命名需遵循语义化规范，例如`feature/user-authentication`或`bugfix/payment-gateway`，并在提交前通过`gitbranch-vv`检查当前分支状态，确保未进行不必要的合并操作。在提交代码前，必须使用`gitstatus`查看未暂存文件，并通过`gitdiff`对比本地修改与远程历史，确保每一行代码变更都对应一个明确的提交意图。

每次提交必须包含完整