WebStorm提示‘Corresponding file is not included in tsconfig.json’问题求助

问题概述 #

开发Node.js+TypeScript项目时，IDE（WebStorm/GoLand）在通过ESLint、Prettier格式化代码（如保存操作）时，随机弹出Corresponding file is not included in tsconfig.json错误。已尝试清除IDE缓存、使用IDE修复功能、重装IDE并重置设置，问题仍存在。

环境信息 #

• WebStorm版本：2024.2.1（2024.2.0、2024.1版本同样存在问题）
• 操作系统：Fedora 40
• Node.js版本：22.8.0（21.1.0版本也有问题，通过nvm安装）
• 包管理器：yarn 4.1.1

配置文件 #

tsconfig.json #

{
  "compilerOptions": {
    "module": "commonjs",
    "esModuleInterop": true,
    "target": "ES2020",
    "noImplicitAny": true,
    "moduleResolution": "node",
    "sourceMap": true,
    "outDir": "dist",
    "baseUrl": ".",
    "paths": {
      "*": ["node_modules/*"]
    },
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true
  },
  "include": ["src/**/*"]
}

tsconfig.eslint.json #

{
  "extends": "./tsconfig.json",
  "exclude": ["../node_modules", "node_modules"]
}

package.json依赖片段 #

"devDependencies": {
    "@types/bcrypt": "^5.0.2",
    "@types/body-parser": "^1.19.5",
    "@types/config": "^3.3.2",
    "@types/cors": "^2",
    "@types/eslint": "^8",
    "@types/express": "^4.17.20",
    "@types/google-protobuf": "^3.15.12",
    "@types/luxon": "^3",
    "@types/node": "^20.8.10",
    "@types/node-cron": "^3.0.11",
    "@types/uuid": "^9.0.8",
    "@typescript-eslint/eslint-plugin": "^6.9.1",
    "@typescript-eslint/parser": "^6.9.1",
    "eslint-config-prettier": "^9.1.0",
    "eslint-plugin-prettier": "^5.1.2",
    "grpc-tools": "^1.12.4",
    "grpc_tools_node_protoc_ts": "^5.3.3",
    "prettier": "3.1.0",
    "typescript": "^5.2.2"
  },
  "dependencies": {
    "@bufbuild/buf": "^1.29.0",
    "@bufbuild/protobuf": "^1.7.2",
    "@bufbuild/protoc-gen-es": "^1.7.2",
    "@connectrpc/protoc-gen-connect-es": "^1.3.0",
    "@discordjs/rest": "^2.2.0",
    "@grpc/grpc-js": "^1.10.1",
    "axios": "^1.6.2",
    "bcrypt": "^5.1.1",
    "body-parser": "^1.20.2",
    "cors": "^2.8.5",
    "discord.js": "^14.13.0",
    "dotenv": "^16.3.1",
    "eslint": "^8.52.0",
    "express": "^4.18.2",
    "luxon": "^3.4.4",
    "mysql2": "^3.7.1",
    "node-cron": "^3.0.3",
    "pino": "^8.17.2",
    "pino-pretty": "^10.3.1",
    "protoc": "^1.1.3",
    "reflect-metadata": "^0.2.1",
    "sequelize": "^6.35.2",
    "sequelize-typescript": "^2.1.6",
    "uuid": "^9.0.1",
    "yaml": "^2.3.4"
  },

排查与解决方法 #

• 修正tsconfig.eslint.json的路径配置：当前exclude中的../node_modules属于无效路径（该文件与tsconfig.json同目录），会导致TS解析时路径混乱。修改为：

  "exclude": ["node_modules"]
  

• 确认ESLint的TS配置指向：检查项目根目录的.eslintrc（或.eslintrc.json）文件，确保parserOptions.project明确指向tsconfig.eslint.json，避免ESLint与IDE使用不同的TS配置：

  "parserOptions": {
    "ecmaVersion": "latest",
    "sourceType": "module",
    "project": "./tsconfig.eslint.json"
  }
  

• 禁用Yarn 4的PnP模式：Yarn 4默认的PnP模式可能导致IDE对TS文件的解析异常。在项目根目录创建/修改.yarnrc.yml，添加：

  nodeLinker: node-modules
  

  之后执行yarn install重新生成node_modules目录。

• 手动重启TypeScript服务：在WebStorm中，打开View > Tool Windows > TypeScript，点击工具栏中的重启按钮，强制刷新TS服务的文件索引。

• 升级TypeScript版本：当前使用的TS 5.2.2与WebStorm 2024.2的兼容性可能存在问题，升级到最新稳定版（如5.3.3）：

  yarn add typescript@latest --dev
  

• 统一IDE与终端的Node.js版本：在WebStorm中进入File > Settings > Languages & Frameworks > Node.js and NPM，选择nvm中安装的22.8.0版本，确保IDE与终端使用相同的Node环境，避免依赖解析不一致。

• 检查项目中是否存在多份tsconfig文件：如果项目子目录中有其他tsconfig文件，IDE可能自动切换配置导致识别错误。确保所有TS文件都被主tsconfig.json的include规则覆盖，或在ESLint配置中明确指定唯一的项目配置文件。

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