2025年软件行业前端开发部前端工程师页面编写规范手册.docxVIP

2025年软件行业前端开发部前端工程师页面编写规范手册

第1章项目基础与环境配置

1.1项目目录结构规范

核心目录采用严格的层级划分，根目录下仅保留`src`（）、`public`（静态资源）及`assets`（图片/字体）三个核心文件夹，禁止在根目录直接存放`.js`、`.css`或`.`文件，以避免构建工具混淆。遵循“单一职责”原则，`src`文件夹下按业务模块拆分为`pages`、`components`、`utils`、`api`等子目录，每个子目录仅负责特定功能逻辑，严禁跨目录调用，确保代码可复用性。

组件文件需遵循命名规范，如`Button.js`、`Header.css`，并在`components`目录下建立统一的`index.js`入口文件，通过`import`语句自动加载该组件，实现组件化封装。样式文件（`.css`、`.scss`、`.less`）必须放置在`src`文件夹内，严禁依赖外部CDN引入样式，所有自定义样式需通过BEM命名法命名，如`.btn-primary`、`.modal__dialog`，保持类名唯一性。图片与资源文件统一存放于`assets`目录，所有静态资源（如Logo、图标、背景图）均通过`src`相对路径引用，禁止硬编码绝对路径，便于跨平台部署与资源清理。