如何解决husky pre-commit钩子中ESLint版本不匹配的报错问题？

1. 锁定ESLint版本，避免调用全局/高版本实例 #

• 问题根源是npx eslint可能调用了全局安装的ESLint 9.0.0，而非项目本地的8.15.0。执行命令时强制使用本地依赖：

  npx --no-install eslint .
  

• 检查并卸载全局ESLint（如果存在）：

  npm uninstall -g eslint
  

• 在package.json的scripts中添加专属lint脚本，确保每次调用都指向本地版本：

  "scripts": {
    "lint": "eslint ."
  }
  

  后续用npm run lint替代直接npx eslint。

2. 处理lint-staged版本提示 #

• 当前使用的lint-staged@13.2.2的版本提示可直接忽略；若要彻底消除提示，可升级到兼容ESLint 8.x的14.x稳定版（无需强制升级到15.2.2）：

  npm install lint-staged@^14.0.0 --save-dev
  

• 检查.husky/pre-commit钩子配置，确保调用的是本地lint脚本而非直接npx eslint：

  # .husky/pre-commit内的内容修改为
  npm run lint
  

3. 确保ESLint配置文件被正确识别 #

• 确认.eslintrc.js在项目根目录，文件名无拼写错误（如不要写成.eslintrc或.eslintrc.json）。
• 在.eslintrc.js中明确声明配置规则，强化旧版格式识别：

  module.exports = {
    root: true,
    extends: 'google',
    // 其他自定义规则...
  };
  

• 清除缓存并重装依赖，避免缓存导致的版本混乱：

  npm cache clean --force
  rm -rf node_modules package-lock.json
  npm install
  

4. 验证配置有效性 #

• 执行本地lint命令测试配置是否生效：

  npm run lint -- your-target-file.js
  

• 若仍报错，添加--debug参数查看详细日志，定位配置文件查找路径：

  npm run lint -- --debug your-target-file.js
  

内容的提问来源于stack exchange，提问作者Ellen