金融行业科技部前端工程师前端页面开发手册（执行版）.docxVIP

金融行业科技部前端工程师前端页面开发手册（执行版）

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

1.1项目根目录组织原则

前端开发项目的根目录是团队协作的基石，其组织原则必须遵循“单一入口、职责分离、版本控制清晰”的架构理念，确保新成员能快速融入并理解代码流向。

根目录应严格划分为src、public、assets、config四个核心子目录，严禁在根目录直接存放HTML文件或JS逻辑文件，以避免混淆全局路径并防止误操作。src目录下需进一步细分为components、layouts、utils等子文件夹，其中components存放所有可复用组件，layouts存放页面结构，utils存放通用工具函数，通过命名约定实现逻辑的模块化。

根目录下必须保留.gitignore文件，明确列出忽略的文件类型，如node_modules、dist包、前端缓存文件、本地配置文件及测试数据，确保版本控制系统高效运行。配置文件（如package.json、tsconfig.json、index.）应位于根目录或public目录，且版本号需与依赖包保持一致，防止因版本冲突导致编译错误。根目录应包含README.md文档，清晰阐述项目技术栈、部署流程、环境依赖及常见问题排查指南，降低新成员的入门门槛。

目录结构需通过`.gitignore`和`.