全局安装ESLint后执行失败，本地node_modules路径调用问题求助

Hey，我之前也碰到过类似的情况，全局装了ESLint但跑不起来检查，大概率是依赖缺失或者路径/配置的问题，给你一步步排查的方案：

1. 先确认全局ESLint是否真的装好了 #

先跑这个命令验证全局安装状态：

npm list -g eslint

如果能输出ESLint的版本号，说明全局安装没问题；要是提示找不到包，那就重新执行全局安装命令——Windows记得用管理员权限打开终端，Mac/Linux要加sudo：

# Windows（管理员终端）
npm install -g eslint

# Mac/Linux
sudo npm install -g eslint

2. 补全Airbnb风格指南的本地依赖 #

这是最常见的坑！你选了Airbnb的风格，但全局ESLint没法读取项目本地的依赖包。Airbnb的基础配置需要eslint-config-airbnb-base和eslint-plugin-import这些依赖，必须在项目根目录安装本地版：

npm install eslint eslint-config-airbnb-base eslint-plugin-import --save-dev

别嫌麻烦，本地装一套依赖能避免很多全局和本地环境不兼容的问题。

3. 检查配置文件是否正常生成 #

确认项目根目录下有.eslintrc.js文件，打开看看内容是不是类似这样：

module.exports = {
  env: {
    browser: true,
    es2021: true,
  },
  extends: [
    'airbnb-base',
  ],
  parserOptions: {
    ecmaVersion: 'latest',
  },
  rules: {
    // 这里可以加自定义规则
  },
};

要是文件不存在或者内容为空，说明eslint --init没执行成功，回到项目根目录重新跑一遍初始化命令，确保每一步都选对了。

4. 用正确的方式执行检查 #

• 推荐用本地ESLint：直接用npx调用，它会自动找项目里的node_modules/.bin/eslint，不用手动输路径：

  npx eslint app.js
  

• 要是非要用全局ESLint，得让它读取本地的依赖，加个参数就行：

  eslint app.js --resolve-plugins-relative-to .
  

  这个参数告诉ESLint从当前项目目录找需要的插件，解决全局版本找不到本地包的问题。

5. Windows用户检查PATH环境变量 #

如果是Windows系统，可能全局的eslint命令没加到系统PATH里。先找npm全局包的路径：

npm config get prefix

把这个路径下的bin文件夹（比如C:\Users\你的用户名\AppData\Roaming\npm\bin）加到系统环境变量的PATH里，重启终端后再试eslint app.js。

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