互联网行业技术部技术工程师代码编写规范手册.docxVIP

互联网行业技术部技术工程师代码编写规范手册

第1章代码编写基础规范

1.1项目结构与目录组织原则

在构建互联网技术架构时，清晰的项目结构是团队协作的基石，它直接决定了代码的可维护性与扩展性。

遵循扁平化层级，避免深层嵌套，通常根目录为`src`，子目录按功能划分，最深层不超过3-4级，例如`src/modules/user`下直接存放`controller`和`service`，禁止出现`src/modules/user/controller/controller`这样四级以上的嵌套。统一使用大驼峰命名法（PascalCase）表示公共类、接口和函数，而内部私有工具类或单文件函数使用小驼峰（camelCase），如`UserService`对应`UserService.java`，但`utils/DateUtils.java`中的`getDate`方法保持小驼峰。

严格区分业务逻辑与基础设施代码，业务代码位于`src/main/java/com/company`下，基础设施（如数据库连接池配置、日志框架代码）位于`src/main/resources`或独立的`src/main/java/com/company/config`包中，严禁将数据库驱动类直接混入业务代码包。引入依赖包时必须遵循`groupId:artifa