游戏行业前端部前端工程师网页开发规范手册 (2).docxVIP

游戏行业前端部前端工程师网页开发规范手册

第1章基础规范

1.1代码风格统一

不一致的代码风格是前端项目维护中的隐形杀手。想象一下，在1000行代码中寻找一个拼写错误的变量名，如果缩进、空格、分号用法都千差万别，效率会大打折扣。

统一代码风格能显著降低团队的认知成本。ESLint、Prettier等工具已成为行业标准，但工具只是起点。关键在于建立一套全团队遵循的规则，例如：

-使用`const`、`let`替代`var`

-统一分号或尾随逗号（推荐尾随逗号，现代JS引擎兼容性极佳）

-行宽控制在80-100字符（考虑显示器的普遍分辨率）

-统一函数参数顺序（如：`functiondebounce(func,wait=0){}`）

为什么模板字符串比拼接字符串更优？除了可读性，它能减少23%的语法检查错误率（基于某大型项目统计）。

1.2命名规范

命名是前端工程学的基石，好的命名能抵消50%的文档需求。

变量命名应遵循：

-`useFetchData`（动词短语）优于`data`

-`userProfile`（领域模型）优于`u`

-`isUserProfileLoading`（状态名）优于`loadingFlag`

函数命名需体现职责：

-`calcTotalPrice()`（纯计算）