VSCode 中高效管理 Monorepo 需配置多根工作区、统一 workspace-level settings.json、跨项目 launch.json 及 TypeScript Project References。具体包括：一、用 code --add 添加子目录并保存为 .code-workspace；二、在 workspace 设置中配置 import 路径、ESLint 自动目录与文件监听排除；三、在 .vscode/launch.json 中定义含 sourceMap 和环境变量的调试入口；四、各子项目 tsconfig 启用 composite 与 references，并运行 tsc -b --watch 实现增量构建与类型联动。
如果您正在使用 VSCode 管理包含多个相互依赖子项目的大型代码仓库，则可能面临工作区配置混乱、扩展行为不一致、调试路径错误等问题。以下是针对 Monorepo 场景在 VSCode 中实现高效协同开发的具体操作方式：
本文运行环境：MacBook Pro，macOS Sequoia。
一、使用多根工作区配置
VSCode 原生支持多根工作区，允许将多个独立的子项目文件夹统一纳入单个工作区文件（.code-workspace），从而启用跨包引用跳转、统一设置继承与共享任务定义。
1、在终端中进入 Monorepo 顶层目录，执行 code --add . 将当前目录作为第一个根文件夹加入工作区。
2、依次执行 code --add packages/core、code --add apps/web 等命令添加其余关键子目录。
3、通过菜单栏 File → Save Workspace As… 将当前布局保存为 monorepo.code-workspace 文件。
4、关闭所有窗口后双击该文件，VSCode 将以完整结构加载全部根文件夹，并自动识别各子目录下的 tsconfig.json 或 package.json。
二、配置 workspace-level settings.json
在多根工作区中，settings.json 可作用于整个工作区而非单个文件夹，用于统一控制 TypeScript 版本、ESLint 路径、Prettier 规则等影响跨包协作的关键参数。
1、打开命令面板（Cmd+Shift+P），输入并选择 Preferences: Open Workspace Settings (JSON)。
2、在生成的 settings.json 中添加 "typescript.preferences.importModuleSpecifier": "relative"，确保跨包导入路径始终基于当前文件位置生成。
3、写入 "eslint.workingDirectories": [{ "mode": "auto" }]，使 ESLint 自动探测各子目录中的配置文件并分别执行校验。
4、加入 "files.watcherExclude": { "**/node_modules/**": true, "**/dist/**": true }，避免文件监听器因大量构建产物触发卡顿。
三、定义跨子项目的 launch.json 配置
Monorepo 中常需对特定子项目启动调试会话，同时保留对其他包的源码级断点支持。通过自定义 launch.json 可精确指定运行时入口、环境变量及 sourceMap 解析路径。
1、在工作区根目录下创建 .vscode/launch.json，确保其位于 .code-workspace 同级路径。
2、配置一个名为 "Debug Web App" 的配置项，设置 "program": "${workspaceFolder}/apps/web/src/index.ts" 指向目标入口。
3、添加 "outFiles": ["${workspaceFolder}/apps/web/dist/**/*.js"] 并启用 "sourceMaps": true，确保调试器能正确映射到 TypeScript 源文件。
4、在 "env": { "NODE_ENV": "development" } 中注入环境变量，使子项目运行时行为与开发预期一致。
四、启用 Project References 构建模式
TypeScript 的 Project References 功能可让各子项目独立编译，同时保持类型检查联动。VSCode 在启用该模式后能实时感知依赖变更并触发增量类型检查，显著提升大型 Monorepo 的响应速度。
1、为每个子项目（如 packages/utils）的 tsconfig.json 添加 "composite": true 和 "declaration": true 字段。
2、在依赖方（如 apps/web）的 tsconfig.json 中的 "references" 数组内添加 { "path": "../packages/utils" }。
3、在工作区根目录执行 tsc -b --watch 启动整体构建监听，VSCode 将自动读取 references 关系并优化语言服务性能。
4、在 VSCode 中打开任意被引用的子项目文件，右键选择 Go to References，即可查看所有跨包调用位置。
