ESLint CLI无法检出全部VSCode插件高亮错误的问题求解

1. 校验文件后缀范围不匹配 #

ESLint CLI默认仅校验.js后缀文件，VSCode插件会默认校验所有已适配的前端相关后缀文件（如.jsx、.ts、.tsx、.vue等），如果你的项目包含非js后缀的代码文件，CLI不会主动扫描。

• 修复方式：运行CLI时通过--ext参数指定需要校验的所有文件后缀，示例命令如下：

# React+TS 项目示例
npx eslint . --ext .js,.jsx,.ts,.tsx
# Vue 项目示例
npx eslint . --ext .js,.jsx,.ts,.tsx,.vue

你也可以将后缀配置写入package.json的lint脚本中，避免每次手动输入。

2. 忽略规则差异 #

ESLint CLI默认会读取项目根目录的.eslintignore文件，也会自动识别.gitignore中的忽略规则跳过对应文件，但是VSCode插件不会忽略用户主动打开的文件，哪怕文件处于忽略列表中也会执行校验。

• 验证方式：运行CLI时添加--no-eslintignore参数临时禁用所有忽略规则，对比输出的问题数量是否和插件一致：

npx eslint . --ext .js,.jsx,.ts,.tsx --no-eslintignore

如果输出问题数量匹配，说明你的忽略规则包含了需要校验的文件，调整.eslintignore的规则即可。

3. 配置加载逻辑差异 #

你使用的是多项目归集的单根工作区，若运行CLI的路径不是带有.eslintrc.json的目标项目根目录，ESLint会向上查找父目录的配置文件，导致规则和插件读取的子项目配置不一致。

• 修复方式：先cd到目标项目根目录再执行CLI命令，可添加参数强制仅读取当前目录的配置文件，避免上层配置干扰：

cd 你的目标项目根目录路径
npx eslint . --ext .js,.jsx,.ts,.tsx -c .eslintrc.json --no-eslintrc

4. VSCode插件自定义配置冲突 #

检查VSCode的用户/工作区配置中是否存在ESLint相关的自定义配置，常见影响输出的配置项如下：

• eslint.validate：自定义添加了额外的校验文件类型，CLI未对应添加后缀
• eslint.rules.customizations：在VSCode中临时修改了规则的报错等级，和配置文件中的规则等级不一致
• eslint.workingDirectories：自定义了插件的工作目录，和你运行CLI的目录不一致
  将相关配置重置为默认后再对比输出结果即可。

5. 模块识别规则差异 #

部分ESLint规则仅会对识别为ES模块的文件生效，VSCode打开单文件时会自动识别模块类型，CLI批量扫描时可能会因为项目package.json未配置"type": "module"，将文件识别为CommonJS模块，跳过部分规则校验。你可以在.eslintrc.json中添加配置强制统一模块类型：

{
  "parserOptions": {
    "sourceType": "module"
  }
}

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