提交时,Husky 和 ESLint 自动帮我们检查代码

你是不是也有过这样的经历:匆忙提交代码后,才发现有些低级错误没发现?别担心,今天我来教你如何用 Husky + ESLint 在提交代码时自动检查,确保每次提交的代码都是干净规范的!

简单理解这些工具

  • Husky:就像你代码仓库的"门卫",在你想提交代码(git commit)时,它会自动执行一些检查工作
  • ESLint:代码"质检员",专门检查代码质量和风格是否符合规范
  • Prettier:代码"美容师",自动格式化代码,保持风格统一
  • lint-staged:智能"筛选器",只检查本次修改的文件,不浪费时间检查整个项目

一步步设置代码提交自动检查

1. 首先安装需要的工具

打开终端,在你的项目根目录下运行:

bash 复制代码
npm install --save-dev husky eslint prettier lint-staged eslint-plugin-prettier eslint-config-prettier

2. 配置代码风格规则

创建 .prettierrc.js 文件(用于定义代码格式规则):

javascript 复制代码
module.exports = {
  printWidth: 120,    // 每行最多120字符
  tabWidth: 2,        // 缩进2个空格
  useTabs: false,     // 不使用制表符
  semi: false,        // 不加分号
  singleQuote: true,  // 使用单引号
  trailingComma: 'none', // 不加尾随逗号
  bracketSpacing: true, // 对象、数组加空格
  arrowParens: 'always' // 箭头函数参数总是加括号
}

创建或修改 .eslintrc.js 文件(用于定义代码质量规则):

javascript 复制代码
module.exports = {
  root: true,
  env: {
    browser: true,
    node: true,
    es6: true
  },
  extends: [
    'prettier',
    'plugin:prettier/recommended'  // 整合prettier和eslint
  ],
  rules: {
    // 这里可以添加你自己的代码规则
  }
}

3. 设置 Husky 自动检查

初始化 Husky:

bash 复制代码
npx husky-init

这会在你的项目中创建一个 .husky 文件夹,里面有一个 pre-commit 文件。

修改 package.json 文件,添加以下内容:

json 复制代码
{
  "scripts": {
    "lint-staged": "lint-staged --allow-empty",
    "lint-staged:js": "eslint --ext .js,.jsx,.ts,.tsx"
  },
  "lint-staged": {
    "**/*.{js,jsx,ts,tsx}": "yarn run lint-staged:js",
    "**/*.{js,jsx,tsx,ts,less,md,json}": [
      "prettier --write"
    ]
  }
}

然后修改 .husky/pre-commit 文件中的内容为:

bash 复制代码
#!/bin/sh
. "$(dirname "$0")/_/husky.sh"

yarn lint-staged  # 或者 npm run lint-staged

4. 大功告成!

现在,每当你执行 git commit 时,Husky 就会自动:

  1. 检查你修改的文件是否符合 ESLint 规则
  2. 自动用 Prettier 格式化代码
  3. 如果有错误会阻止提交并提示你修复
  4. 一切正常才会完成提交

实际效果

当你提交代码时,如果代码有问题,你会看到类似这样的提示:

css 复制代码
⚠️  发现ESLint错误:
src/components/Button.js
  第15行:缺少分号

❌ 请修复以上错误后重新提交

修复错误后再次提交即可。如果代码没问题,就会自动格式化并成功提交!

相关推荐
笨笨狗吞噬者30 分钟前
【uniapp】解决小程序分包下的json文件编译后生成到主包的问题
前端·uni-app
IT_陈寒43 分钟前
Redis 7个性能优化技巧,让我们的QPS从5k提升到20k+
前端·人工智能·后端
.又是新的一天.1 小时前
健身房预约系统SSM+Mybatis(五、预约展示)
前端·mybatis
晴殇i1 小时前
DOM嵌套关系全解析:前端必备的4大判断方法与性能优化实战
前端·javascript·面试
似水流年_zyh2 小时前
canvas涂抹,擦除功能组件
前端
胖虎2652 小时前
前端多文件上传核心功能实现:格式支持、批量上传与状态可视化
前端
胖虎2652 小时前
Vue2 项目常用配置合集:多语言、SVG 图标、代码格式化、权限指令 + 主题切换
前端
一键定乾坤2 小时前
npm 源修改
前端
parade岁月2 小时前
Vue 3 响应式陷阱:对象引用丢失导致的数据更新失效
前端
掘金安东尼2 小时前
GPT-6 会带来科学革命?奥特曼最新设想:AI CEO、便宜医疗与全新计算机
前端·vue.js·github