VSCode ESLint插件在NestJS TypeScript项目中报解析错误

问题背景 #

开发NestJS TypeScript项目时，在VSCode中启用ESLint插件并重启后，所有TypeScript文件均出现报错：

Parsing error: Cannot read file 'c:\users\pradipm\clients\myproject\cliet_dir\project_folder\tsconfig.app.json'.eslint

即使按报错路径添加文件，仍会提示上级目录缺少该文件，直至C盘根目录。项目相关配置文件如下：

tsconfig.lib.json #

{  
  "extends": "../../tsconfig.json",  
  "compilerOptions": {    
    "declaration": true,    
    "outDir": "../../dist/libs/connector-client"  
  },  
  "include": ["src/**/*"],  
  "exclude": ["node_modules", "dist", "test", "**/*spec.ts"]
}

根目录tsconfig.json #

{  
  "compilerOptions": {    
    "module": "commonjs",    
    "declaration": true,    
    "removeComments": true,    
    "emitDecoratorMetadata": true,    
    "experimentalDecorators": true,    
    "allowSyntheticDefaultImports": true,    
    "sourceMap": true,    
    "outDir": "./dist",    
    "baseUrl": "./",    
    "incremental": true,    
    "target": "esnext",    
    "lib": [      
      "ESNEXT"    
    ],    
    "paths": {    
      // 项目特定路径配置等    
    }  
  }
}

.eslintrc配置 #

module.exports = {  
  parser: '@typescript-eslint/parser',  
  parserOptions: {    
    project: ['./tsconfig.json'],    
    sourceType: 'module',    
    tsconfigRootDir: __dirname,  
  },  
  plugins: ['@typescript-eslint/eslint-plugin'],  
  extends: [    
    'plugin:@typescript-eslint/recommended',    
    'plugin:prettier/recommended',  
  ],  
  root: true,  
  env: {    
    node: true,    
    jest: true,  
  },  
  ignorePatterns: ['.eslintrc.js'],  
  rules: {    
    '@typescript-eslint/interface-name-prefix': 'off',    
    '@typescript-eslint/explicit-function-return-type': 'off',    
    '@typescript-eslint/explicit-module-boundary-types': 'off',    
    '@typescript-eslint/no-explicit-any': 'off',  
  },
};

VSCode settings.json #

{    
  "projectManager.vscode.ignoredFolders": [        
    "node_modules",        
    "out",        
    "typings",        
    "test"    
  ],    
  "eslint.format.enable": true,
}

解决方案 #

1. 确认工作区信任状态 #

VSCode的工作区信任机制可能限制ESLint访问文件，点击左下角信任状态标记，将当前项目工作区设为信任。

2. 修正ESLint的tsconfig路径配置 #

在.eslintrc的parserOptions中，明确指定所有相关的tsconfig文件，避免ESLint自动查找不存在的tsconfig.app.json：

parserOptions: {
  project: ['./tsconfig.json', './libs/connector-client/tsconfig.lib.json'], // 替换为实际子项目路径
  sourceType: 'module',
  tsconfigRootDir: __dirname,
}

3. 清除ESLint缓存并重启服务 #

• 打开VSCode命令面板（Ctrl+Shift+P），执行ESLint: Restart ESLint Server
• 删除项目根目录下的.eslintcache文件（若存在）
• 重启VSCode

4. 配置ESLint工作目录 #

在VSCode设置中（Ctrl+,），搜索ESLint: Working Directories，添加项目根目录路径：

"eslint.workingDirectories": ["./"]

若仍有问题，可临时在.eslintrc中添加createDefaultProgram: true（会增加启动时间，优先确保路径正确后移除）：

parserOptions: {
  // ...其他配置
  createDefaultProgram: true,
}

5. 修复tsconfig的语法错误 #

根目录tsconfig.json中的paths部分存在语法缺失，补全正确的键值对格式，例如：

"paths": {
  "@your-project/*": ["src/*"]
}

无效的tsconfig语法会导致ESLint解析失败，触发错误的文件查找行为。

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