JavaScript代码规范的核心是统一协作习惯、提升可读性与可维护性,应选用ESLint+Prettier+主流规则集并坚持执行;ESLint用于静态检查,Prettier专注格式化,husky+lint-staged实现提交前自动校验,团队需从项目初期就配置并纳入CI流程。

JavaScript 代码规范的核心是统一团队协作习惯、提升可读性与可维护性,而不是追求某种“绝对正确”的写法。主流规范(如 ESLint + Prettier + Airbnb/Standard 规则集)已足够成熟,关键在于选一套、配好、坚持用。
用 ESLint 做静态检查
ESLint 是目前最主流的 JavaScript/TypeScript 代码质量检查工具,能捕获潜在错误、风格问题和反模式。
- 安装:运行
npm install eslint --save-dev,再通过npx eslint --init交互式生成配置文件(推荐选 “To check syntax and find problems” + “JavaScript modules (import/export)” + “React” 或 “None of these” 按需) - 常用配置来源:直接继承
eslint-config-airbnb-base(纯 JS)、eslint-config-standard或@typescript-eslint/eslint-plugin(TS 项目) - 在
.eslintrc.js中启用规则时,优先用"error"或"warn",避免全关("off"),尤其禁用eval、with、未声明变量等高危项
用 Prettier 统一格式化
Prettier 不做逻辑检查,只专注“怎么换行、缩进、引号、分号”,解决团队间格式争论。
- 安装:
npm install prettier --save-dev,加.prettierrc配置(常见配置如{"semi": true, "singleQuote": true, "tabWidth": 2}) - 和 ESLint 配合:装
eslint-config-prettier关闭 ESLint 中与 Prettier 冲突的规则,再用eslint-plugin-prettier把 Prettier 当作 ESLint 规则运行 - 编辑器里开启 “Format on Save”,VS Code 用户装官方 Prettier 插件并设默认 formatter 即可自动美化
配合 Git 做提交前校验
靠人手动跑检查容易遗漏,建议用 husky + lint-staged 在 git commit 前自动执行。
立即学习“Java免费学习笔记(深入)”;
- 安装 husky:
npx husky-init && npm install,它会自动生成.husky/pre-commit - 在 pre-commit 脚本中加入:
npx lint-staged - 配置
lint-staged:在package.json加字段,例如:"lint-staged": { "src/**/*.{js,jsx,ts,tsx}": ["eslint --fix", "prettier --write"] }
团队落地的小建议
工具只是辅助,真正起作用的是团队共识和持续执行。
- 新项目初始化时就配好 ESLint + Prettier + husky,别等代码堆多了再补
- 把
.eslintrc.js和.prettierrc提交进仓库,确保所有人用同一套规则 - CI 流程(如 GitHub Actions)中加入
npm run lint步骤,不通过则禁止合并 - 允许个别文件临时禁用规则(如
// eslint-disable-next-line no-console),但需加注释说明原因











