互联网行业技术部开发人员代码编写测试手册.docxVIP

互联网行业技术部开发人员代码编写测试手册

第1章项目结构与开发环境搭建

1.1项目根目录规范与目录树结构

项目的根目录（RootDirectory）是代码组织的核心枢纽，遵循严格的命名与层级规范，确保所有开发人员无需查阅文档即可理解项目全貌。

根目录下应仅保留`README.md`、`.gitignore`和`Makefile`三个核心文件，其余任何同名文件均视为未定义，防止因文件名冲突导致编译或构建失败。子目录命名需采用语义化规则，例如`src`存放，`tests`存放测试用例，`docs`存放文档，`config`存放配置文件，避免使用`lib`、`bin`、`obj`等通用但易混淆的别名。

核心业务模块必须位于`src/main/java`或`src/main/python`等标准路径下，而工具类、辅助类或第三方依赖库应统一放置在`src/main/resources`或`src/main/resources/lib`中。目录结构必须支持清晰的Git分支管理，每个功能点或特性开发必须划分为独立的`feature/xxx`分支，且`feature/xxx`分支下严禁混入`main`或`develop`主干代码。必须建立`.gitignore`文件，明确列出编译产物、本地缓存、日志文件、IDE配置