游戏行业技术部程序员代码编写规范手册.docxVIP

游戏行业技术部程序员代码编写规范手册

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

1.1项目根目录规范与依赖管理

项目根目录（RootDirectory）是构建整个应用的“中枢神经”，必须严格遵循标准命名规则。建议命名为`src`或`app`，严禁直接以`project`、`main`等含义模糊的词汇命名，以避免混淆。根目录下应包含一个名为`package.json`的根包文件，该文件不仅声明了项目的运行时依赖（Node.js项目），还记录了开发依赖（如lint、format工具），确保所有成员共享统一的依赖版本策略，防止因版本冲突导致的构建失败。依赖管理需采用语义化版本控制（SemVer）机制，在`package.json`中明确列出`dependencies`（生产环境）和`devDependencies`（开发环境）。例如，若项目需要处理异步任务，必须显式声明`express`或`fastify`作为核心依赖，并在`package-lock.json`中锁定其精确版本号，确保环境一致性。对于大型项目，还需通过`package.json`的`peerDependencies`定义外部库的版本要求，例如要求前端框架版本不低于18.0.0，以保障前后端通信的兼容性。

根目录结构应体现分层思想，通常包含`config`（配置文件）、`