互联网行业研发部开发人员代码编写规范手册（执行版）.docxVIP

互联网行业研发部开发人员代码编写规范手册（执行版）

第一章项目结构与代码组织

1.1目录层级规范

在构建互联网研发项目的骨架时，目录层级不仅是为了区分文件，更是为了建立清晰的职责边界和团队协作的视觉导航。规范的层级结构应遵循“根目录为全貌，子目录为职责，文件为单元”的原则，避免过度嵌套导致维护困难。

根目录（RootDirectory）应严格定义为项目入口点，仅存放`README.md`、`package.json`（或`pom.xml`）、`Dockerfile`或`Makefile`等构建与启动脚本，严禁在此放置任何业务代码文件，以确保`gitclone`后的初始状态纯净且可执行。按照业务模块划分一级目录（如`src/main/java/com/example/project`或`src/main/resources`），每个一级目录代表一个核心业务域，目录名应使用小写字母和下划线分隔，且命名需遵循命名空间隔离原则，防止不同团队模块间发生命名冲突。

在一级目录下建立二级目录，用于进一步细分功能模块，例如在`src/main/java`下创建`ject.user`对应用户中心模块，体现“模块-功能”的三级结构，便于快速定位代码归属。二级目录内部应建立三级目录，用于组织具体的类、接口或配置类，通常采用`controller`,