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

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

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

1.1目录结构定义与文件命名规则

目录结构需严格遵循“应用层在前、服务层在后、数据层在最底”的垂直分层原则，确保代码逻辑清晰，便于新人快速定位业务代码与基础设施代码。具体而言，根目录下应包含`src`子目录存放所有业务逻辑，`src/server`存放后端API接口实现，`src/client`存放前端组件代码，`src/database`存放数据库迁移脚本，而`src/config`则集中管理全局配置，避免配置污染业务代码。文件命名必须采用“小写+下划线+驼峰命名法”的混合规则，并严格遵循语义化命名原则，例如`user_profile_service.ts`而非`UserProfile.js`。所有TypeScript文件后缀统一为`.ts`，JavaScript文件后缀统一为`.js`，避免使用`.jsx`或`.tsx`混用导致编译冲突。

在`src`目录下，所有文件必须位于`src/`根目录或其子目录中，严禁出现`src/../../../config`这种越层访问文件的情况，这是防止构建时文件丢失和路径解析错误的关键防线。同时，文件路径长度应控制在100字符以内，防止Windows系统路径过长导致的文件读