游戏行业技术部程序员游戏开发技术手册.docxVIP

游戏行业技术部程序员游戏开发技术手册

第1章基础架构与工程规范

1.1项目组织与目录结构

项目根目录遵循严格的Monorepo混合模式，将核心业务代码、构建工具和配置文件统一存放于`src/`根目录，确保所有开发者在同一工作目录下即可运行`npmrunbuild`命令，无需跨目录执行，极大降低了环境配置复杂度。采用语义化版本控制（SemVer）作为版本号命名标准，例如`1.2.3-alpha.1`，其中`1.2`代表主版本号，`3`代表次版本号，`alpha.1`代表预发布状态，便于团队快速识别当前迭代阶段及未来升级路径。

目录结构严格遵循“功能模块隔离”原则，每个功能点（Feature）独立为一个子目录，如`src/features/user-auth/login-service/`，确保单一职责原则（SRP）落地，避免一个目录内混杂多个功能导致的耦合度高、测试困难。所有依赖包必须通过`package.json`中的`dependencies`和`devDependencies`字段显式声明，禁止使用隐式依赖或依赖冲突包，并在`package-lock.json`中锁定精确哈希值，防止因版本升级导致构建环境不一致。配置文件（如`tsconfig.json`、`vite.config.ts`）位于根目录，其中`com