汽车行业研发部前端工程师前端开发工作手册.docxVIP

汽车行业研发部前端工程师前端开发工作手册

第1章项目结构与基础规范

1.1项目目录组织原则

本章节旨在确立研发前端项目的核心目录逻辑，遵循“逻辑分组、职责单一、便于协作”的设计思想，确保代码结构清晰且符合团队协作习惯。

根目录采用语义化命名，将`src`下的核心业务逻辑与`assets`下的静态资源严格分离，避免功能耦合，例如将`src/components/`定义为UI组件库，`src/views/`定义为页面视图，`src/utils/`定义为全局工具函数，`src/store/`定义为状态管理逻辑。必须严格执行“单一职责原则”，每个目录项（如`src/modules/user/`）仅负责一个功能模块，禁止将用户登录、角色权限、数据列表等逻辑混装在同一个目录下，防止耦合度过高。

目录层级应扁平化，避免过深的嵌套结构，通常建议深度不超过5层，过深的目录会导致代码查找困难，且不利于CI/CD流水线的高效扫描与构建。公共组件（如通用的`Button`,`Modal`,`Table`）必须提取至`src/components/`根目录，并建立统一的注册机制，确保所有业务模块复用，避免重复造轮子。配置文件（如`babel.config.js`,`vite.config.js`）应统一放置在根目录，明确指定开发、测试、生产环境