WebStorm在Yarn Workspaces中无法识别tsconfig extends链怎么办？

问题场景 #

我正在使用Yarn Workspaces，每个模块中的tsconfig.json文件都继承自根目录的配置文件。此前WebStorm可以识别这些继承链，但现在突然无法识别了。我已经清理了缓存、重启了TypeScript服务，且确认使用tsc时TypeScript本身对这些配置无任何问题。

示例配置：

• /src/my-module/tsconfig.json

{
  "extends": "../../tsconfig.backend.json"
}

• tsconfig.backend.json

{
  "extends": "./tsconfig.base.json",
  "compilerOptions": {
    "jsxImportSource": "hono/jsx",
    "resolveJsonModule" : true,
    "esModuleInterop": true
  }
}

• tsconfig.base.json

{
    "compilerOptions": {
      "target": "ESNext",
      "module": "ESNext",
      "moduleResolution": "Bundler",
      "strict": true,
      "lib": ["esnext", "DOM"],
      "types": [ "vite/client", "node"],
      "jsx": "react-jsx",
      "esModuleInterop": true
    },
  "include": ["global.d.ts"],
  "exclude": ["node_modules"]
}

解决步骤 #

1. 确认包管理器与TS版本配置 #

• 打开File > Settings > Languages & Frameworks > JavaScript > Package Managers，确保Package Manager选择Yarn，且WebStorm正确识别工作区根目录。
• 进入File > Settings > Languages & Frameworks > TypeScript，将TypeScript版本设置为项目本地安装的版本，避免内置版本与项目依赖的TS版本不兼容导致解析异常。

2. 手动标记TS配置文件 #

• 右键点击根目录的核心TS配置文件（如tsconfig.base.json），选择Mark as > TypeScript Configuration File，让WebStorm明确这是项目的基础配置。
• 对每个子模块的tsconfig.json重复上述操作，确保WebStorm将它们纳入继承链的识别范围。

3. 调整TypeScript服务范围 #

• 在File > Settings > Languages & Frameworks > TypeScript的Service区域，勾选Use TypeScript service（未勾选的话），然后点击Restart service。
• 检查该页面的Include和Exclude列表，确保子模块所在目录没有被意外排除。

4. 深度清理WebStorm缓存 #

• 执行File > Invalidate Caches...，勾选Clear file system cache and local history，点击Invalidate and Restart。彻底清除缓存后WebStorm会重新索引项目，修复可能的索引异常。

5. 验证tsconfig相对路径正确性 #

• 虽然tsc能正常解析，但WebStorm的路径校验更严格。确认子模块tsconfig中extends的相对路径完全匹配实际文件位置，比如示例中../../tsconfig.backend.json是否对应正确的上级目录结构。

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