互联网行业研发部研发工程师代码编写规范手册（执行版）.docxVIP

互联网行业研发部研发工程师代码编写规范手册（执行版）

第1章基础规范与编码风格

1.1项目根目录与目录结构

项目根目录（ProjectRootDirectory）是存放所有、构建配置文件及依赖文件的绝对起始位置，通常位于操作系统根目录（如`/home/user/project`或`C:\Users\user\project`），在此目录下执行`gitclone`或`npminstall`命令，所有其他目录均相对于此根目录建立。目录结构需遵循“单一职责原则”，根目录下应包含`src`（）、`tests`（测试代码）、`docs`（文档）、`config`（配置文件）等核心子目录，严禁在根目录下直接放置二进制文件、日志文件或无关的图片资源。

子目录命名应使用小写字母、连字符或下划线分隔单词（如`src/components`），避免使用空格、特殊字符或中文，且子目录之间需使用明确的分隔符（如`/`）进行层级划分，形成清晰的视觉层级。在大型项目中，建议采用`feature`（特性）或`module`（模块）命名子目录，将功能相关代码逻辑隔离，例如按用户模块划分`src/user`,`src/order`，便于后续的功能迭代和团队协作。配置文件应放置在根目录下的`config`或`.env`子目录中，严禁将数据库密码、APIK