2025年互联网行业前端开发前端开发前端代码开发手册.docxVIP

2025年互联网行业前端开发前端开发前端代码开发手册

第1章

1.1命名规范与变量定义

变量名必须遵循snake_case下划线分隔的命名习惯，且遵循kebab-case驼峰命名法，所有变量名首字母小写，避免使用以数字开头或包含空格、连字符的命名。为每个模块定义唯一的常量，例如定义全局配置常量`API_BASE_URL`和`MAX_RETRY_COUNT`，禁止在代码中直接硬编码字符串路径，需通过环境变量或配置文件注入。

定义函数或类时，参数名必须反映数据含义，如`fetchUserData(userId)`，避免使用`getData()`或`getUser()`等模糊命名，确保代码可读性。函数返回值类型必须明确，对于异步操作返回的数据，必须使用`PromiseT`或`ReturnTypeT`类型注解，禁止使用`any`类型进行泛型推断。

全局变量必须严格限制使用范围，禁止在文件顶部的`global`对象中定义业务逻辑变量，所有业务数据必须封装在具体的类或模块实例中。

1.2代码结构与模块化设计

每个文件应只包含一个单一职责的功能模块，禁止将复杂的业务逻辑拆分到多个文件中，例如禁止在一个文件中同时处理用户认证和订单支付逻辑。所有外部依赖库必须通过`npm`或`yarn`安装，禁止使用`require`或`impor