VSCode多工作区下tsconfig.json默认仅加载最外层配置，需在.code-workspace中启用"typescript.preferences.enableProjectDiagnostics": true并确保各子项目tsconfig.json含compilerOptions、include等必要字段，同时为ESLint和Volar分别配置workingDirectories及Use Tsconfig。
VSCode 多工作区下 tsconfig.json 查找路径失效
VSCode 在 .code-workspace 多项目工作区中，**不会自动为每个子文件夹单独加载其 tsconfig.json**。它默认只认最外层工作区根目录（即 .code-workspace 所在目录）下的 tsconfig.json，其余子项目里的配置会被忽略——哪怕它们各自有合法的 tsconfig.json 和 package.json。
典型现象：子项目 A 的 src/index.ts 里写 import '@/utils'，VSCode 报“Cannot find module '@/utils'”，但运行 npx tsc -p packages/a/tsconfig.json 完全正常。
- 根本原因不是路径写错，而是 TypeScript 语言服务没把子项目目录当作独立上下文启动
- Volar/Vetur/ESLint 等插件都依赖 TS 服务提供的解析能力，TS 服务不加载，它们就“瞎了”
-
.code-workspace文件本身不声明任何 tsconfig 加载逻辑，纯属容器，不参与类型系统配置
必须手动启用 multi-root workspace 的 TS 支持
VSCode 默认禁用多根工作区的 TypeScript 项目感知。要让每个子项目被独立识别，需显式开启：
- 打开命令面板（
Ctrl+Shift+P），执行TypeScript: Select TypeScript Version→ 选Use Workspace Version - 在
.code-workspace文件中添加"settings"块，启用"typescript.preferences.includePackageJsonAutoImports": "auto" - 最关键一步：在
.code-workspace中加入"typescript.preferences.enableProjectDiagnostics": true—— 这会强制 TS 服务扫描所有子文件夹下的tsconfig.json
示例 .code-workspace 片段：
{
"folders": [
{ "path": "packages/a" },
{ "path": "packages/b" }
],
"settings": {
"typescript.preferences.enableProjectDiagnostics": true,
"typescript.preferences.includePackageJsonAutoImports": "auto"
}
}
子项目 tsconfig.json 必须满足最低结构要求
即使启用了 enableProjectDiagnostics，VSCode 仍会跳过不符合基本条件的 tsconfig.json。常见“被无视”的配置包括：
- 缺少
"compilerOptions"字段（哪怕为空对象也不行） -
"include"字段为空或未覆盖实际源码路径，例如写成"include": []或漏掉.vue/.ts文件 -
"extends"指向的父配置不存在，或路径是相对路径（如"../tsconfig.base.json"），而 VSCode 不做跨文件夹解析 - 使用了
"references"但未设"composite": true，TS 服务会直接跳过该配置
验证方式：在子项目根目录下打开任意 .ts 文件，按 Ctrl+Click 跳转一个内部模块，如果能成功跳转，说明该 tsconfig.json 已被加载；否则检查上述四项。
ESLint 和 Volar 需额外对齐工作区路径
即使 TS 服务已识别多个 tsconfig.json，ESLint 和 Volar 仍可能继续报错，因为它们默认不继承 TS 的多项目感知逻辑。
- ESLint：必须在
.vscode/settings.json（非.code-workspace）中设置"eslint.workingDirectories"，列出所有子项目路径，例如：["packages/a", "packages/b"] - Volar：确保每个子项目根目录下都有
tsconfig.json（不能只靠 extends），且Volar: Use Tsconfig设置为true（检查是否被 workspace 设置覆盖） - 若子项目用
jsconfig.json，Volar 默认忽略——Vue 3 项目必须用tsconfig.json，哪怕没写 TS 代码
改完后务必执行 ESLint: Restart ESLint Server 和 TypeScript: Restart TS Server，否则缓存会导致配置不生效。
多工作区下真正起作用的从来不是“哪个 tsconfig 存在”，而是“VSCode 是否愿意为那个目录启动一次独立的 TS 服务实例”。这一步卡住，后面所有路径别名、类型提示、ESLint 规则都会失效——而且错误信息往往指向具体导入语句，让人误以为是代码问题，其实只是编辑器根本没读配置。
