软件行业技术部开发工程师代码编写规范手册.docx

软件行业技术部开发工程师代码编写规范手册

第1章编码基础与项目结构

1.1项目根目录与文件组织原则

项目根目录是软件工程的“心脏”，它定义了代码的生命线，确保所有开发活动围绕统一的架构展开。一个规范的项目根目录通常遵循单一职责原则，将配置、、测试资产及文档严格分离，避免“垃圾进，垃圾出”的情况。

根目录应严格划分为`src/`（）、`tests/`（测试代码）、`docs/`（文档）和`config/`（配置文件）四个独立子目录，杜绝将`.gitignore`或`.idea`等忽略文件混入源码目录。在`src/`目录下，建议采用模块化分层结构，如`api/`存放