互联网行业技术部工程师前端页面开发手册（执行版）.docxVIP

互联网行业技术部工程师前端页面开发手册（执行版）

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

1.1代码编写规范与代码风格

在开发过程中，必须严格遵循前端工程化配置中的ESLint和Prettier规则，确保所有代码自动格式化，禁止出现缩进不一致、括号不匹配或注释格式错误等低级错误。例如，在编写组件时，严禁使用混合格式（如`const=1const=2`），必须统一使用`let`或`var`，并始终将`const`关键字放在`let`之前，以符合现代JS语法规范。代码风格应统一采用阿里巴巴JavaScript规范，特别是针对React和Vue框架，必须严格遵守变量命名、函数命名和组件命名的命名约定，例如将`User`类名统一改为`User`或`UserComponent`，并将`handleLogin`函数名规范化为以动词结尾的命名风格。

所有注释必须遵循“解释性优先”原则，禁止使用`//TODO`或`//FIXME`等占位符式的注释，因为执行版手册要求开发人员必须明确记录当前代码的待办事项和已知风险，以便后续维护者快速定位问题。例如，在复杂的数据处理逻辑旁，必须添加详细的中文注释说明该函数接收的参数类型及返回值含义。代码中必须杜绝硬编码，所有配置项、API地址、密钥等敏感信息必须通过环境变量或配置中