游戏行业研发部程序员游戏引擎开发手册（执行版）.docxVIP

游戏行业研发部程序员游戏引擎开发手册（执行版）

第1章

项目架构与工程规范

1.1项目目录结构定义

根目录下必须严格遵循“应用层在上层，服务层在中层，数据层在下层”的垂直分层原则，严禁将业务逻辑直接堆砌在`main.py`或`index.js`中；每个子模块（如`src/game/engine/core`）必须包含独立的`README.md`文档，清晰列出该模块的依赖包、入口文件路径及核心类/函数定义位置；

所有配置文件（如`config.json`,`package.json`,`Cargo.toml`或`pyproject.toml`）必须位于对应模块的根目录下，且版本号需与`requirements.txt`中的依赖保持一致；代码文件命名需遵循语义化规则，例如将`utils.py`拆分为`utils/__init__.py`和`utils/logger.py`，避免使用`test.txt`或`backup.py`等无意义的后缀名；公共工具类（如`common.py`,`utils.py`）应定义在`src/game/engine/core/utils`中，且所有导入路径必须相对路径，严禁使用绝对路径引用外部库；

单元测试代码必须放置在`tests/unit`目录下，且测试文件命名需包含模块名和测试类名