软件行业研发部程序员代码规范手册.docx

软件行业研发部程序员代码规范手册

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

1.1根目录与模块划分原则

软件项目的根目录是程序员进入开发环境的第一道门槛，合理的根目录结构能像建筑的承重墙一样，为后续所有代码的扩展提供清晰的路径指引和逻辑隔离。在大型分布式系统中，遵循单一职责原则（SRP）是构建可维护架构的基础。

根目录通常应只包含最顶层的配置文件（如`package.json`或`pom.xml`）、环境变量配置（`.env`）以及全局的依赖管理工具（如`npm`或`maven`的根目录），严禁在此目录下直接存放业务代码或测试代码。项目根目录下的子目录应严格遵循“一个目录对应一个