制定JavaScript代码规范的核心目标是提升代码可读性、可维护性和团队协作效率。通过使用ESLint和Prettier统一代码风格，结合husky与lint-staged实现提交前自动化检查；命名上采用语义化的小驼峰式变量函数名、大驼峰式类名、全大写常量名，并用is/has/should前缀标识布尔值；保持文件职责单一，采用ES6模块语法，控制函数长度并合理使用解构赋值与箭头函数；在安全方面强制使用===比较，禁用var，捕获异常并校验用户输入。团队应基于Airbnb或Google规范裁剪出适合项目的版本，定期回顾优化以确保规范持续有效。
制定 JavaScript 代码规范的核心目标是提升代码的可读性、可维护性和团队协作效率。一个良好的 JS 规范不是凭空而来，而是结合项目需求、团队习惯和语言特性逐步形成的统一标准。
1. 使用主流工具统一格式
借助自动化工具能有效减少风格争议，确保每个人提交的代码看起来像一个人写的。
- ESLint：用于检测语法错误和不符合规范的写法，支持自定义规则或使用 Airbnb、Standard 等流行配置。
- Prettier：专注于代码格式化，处理缩进、引号、括号、换行等视觉层面的问题，与 ESLint 配合使用效果更佳。
- 在项目中配置 .eslintrc.js 和 .prettierrc 文件，并通过 husky + lint-staged 在提交前自动检查和格式化代码。
2. 命名清晰且遵循惯例
变量、函数、类的命名直接影响代码的理解成本。
- 使用语义化的变量名，避免单字母或缩写不清的名称，如 userName 比 un 更好。
- 变量和函数用小驼峰式（camelCase），构造函数或类用大驼峰式（PascalCase）。
- 常量全大写加下划线分隔，如 MAX_RETRY_COUNT。
- 布尔类型可加 is、has、should 等前缀，如 isLoading、hasPermission。
3. 保持结构简洁与模块化
良好的结构让代码更容易拆分和测试。
立即学习“Java免费学习笔记（深入）”；
- 每个文件职责单一，避免一个文件包含多个功能模块。
- 优先使用 ES6 模块语法（import/export），不推荐 CommonJS（require/module.exports）在现代前端项目中。
- 避免深层嵌套，控制函数长度在 50 行以内，复杂逻辑应拆分为小函数。
- 合理使用解构赋值、默认参数、箭头函数，但不过度简化导致可读性下降。
4. 注重安全与兼容性
写出功能正确的代码只是第一步，还要考虑运行时的稳定性。
- 始终使用 === 和 !== 进行比较，避免类型强制转换带来的问题。
- 声明变量必须使用 let 或 const，禁用 var。
- 对可能出错的操作进行异常捕获，尤其是异步操作和 API 调用。
- 处理用户输入时做类型校验和边界检查，防止注入或崩溃。
基本上就这些。关键是团队达成一致并坚持执行。初期可以基于 Airbnb 或 Google 的 JS 规范做裁剪，再根据实际项目调整细节。规范不是一成不变的，定期回顾优化才能持续发挥作用。
