2025年游戏行业前端部前端工程师页面开发规范手册.docxVIP

2025年游戏行业前端部前端工程师页面开发规范手册

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

1.1项目根目录与目录结构详解

项目根目录（RootDirectory）是开发环境的全局入口，通常命名为`root`或`project`，所有、配置文件、构建工具和测试用例均在此目录下，严禁在此目录直接存放`.gitignore`或`package.json`等元数据文件。根目录下应包含`src`子目录，用于存放所有生产环境的文件，并在此处配置`package.json`、`tsconfig.json`、`vite.config.js`等核心配置文件，确保构建工具能正确识别项目入口。

根目录结构必须严格遵循`src`下的层级划分，例如`src/components`、`src/pages`、`src/utils`等，避免将全局变量、公共工具函数或测试文件直接写入根目录，以保持代码的纯粹性。子目录结构需体现模块的独立性，如`src/components/Button`、`src/pages/Login`、`src/hooks/useAuth`等，每个子目录应包含该模块下的组件文件、样式文件及对应的单元测试文件，形成完整的闭环。根目录下的`public`子目录仅用于存放静态资源，如`favicon.ico`、`images`文件夹或CDN配