软件行业前端部前端工程师页面开发规范手册（执行版）.docxVIP

软件行业前端部前端工程师页面开发规范手册（执行版）

第1章基本规范

1.1代码命名规范

代码命名看似琐碎，实则是前端工程化的基石。混乱的命名会导致代码难以阅读、维护，甚至引发跨团队协作的障碍。

变量命名应遵循清晰、简洁且见名知意的原则。例如，`userProfile`比`up`或`data`更直观。状态管理中，`isFetching`比`fetchingFlag`更易理解。函数命名需体现其行为，如`calculateTotalPrice`而非`calcTotal`。

组件命名需区分展示型组件（如`UserProfileCard`）与业务逻辑型组件（如`UserEditForm`）。避免使用`div`、`span`等原生标签作为组件名，这会混淆DOM结构与业务层级。

常量命名建议全大写加下划线，如`MAX_PAGE_SIZE`。URL接口命名需统一风格，例如`GET_USERS`或`/api/users`，并保持大小写一致性。

场景举例：某项目中，因`userList`变量同时存储分页数据与筛选条件，导致30%的Bug来自逻辑混淆。改用`userListState`后，问题率下降50%。

1.2代码格式化规范

格式化不单是缩进与换行的问题，而是代码可读性的保障。统一的格式能显著降低理解成本，