VSCode出现import/no-unresolved错误但终端ESLint无报错（Vite+React+TS）

核心排查与修复步骤 #

• 强制VSCode使用项目本地ESLint版本

  1. 打开VSCode设置（快捷键Ctrl+,/Cmd+,）
  2. 搜索ESLint: Use Local Eslint并勾选该选项
  3. 重启ESLint服务：打开命令面板（Ctrl+Shift+P/Cmd+Shift+P），输入ESLint: Restart ESLint Server执行

• 验证版本一致性

  • 终端运行 npx eslint --version 获取项目本地ESLint版本
  • VSCode中打开命令面板，输入ESLint: Show Output Channel，查看输出日志里的ESLint版本号，确认与终端输出一致

• 兜底配置检查（版本一致仍报错时）
  确保.eslintrc.yml已关联TypeScript配置解析路径：

  settings:
    import/resolver:
      typescript:
        project: ./tsconfig.json
  

  同时确认tsconfig.json的路径别名配置正确：

  {
    "compilerOptions": {
      "baseUrl": ".",
      "paths": {
        "@/*": ["src/*"]
      }
    }
  }
  

• 清理缓存

  • 删除项目根目录下的node_modules/.cache文件夹
  • 在VSCode命令面板执行ESLint: Clear Cache命令

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