VSCode实现前端Monorepo架构下的多根工作区深度隔离

先说几个核心判断：VSCode 的多根工作区，本质上就不提供所谓的「深度隔离」。终端、搜索、设置、扩展状态，默认都是共享的。如果你想要那种每个子项目各玩各的、互不干扰的效果，就必须手动配置到每一层。否则，前端子包之间 lint 规则打架、自动导入串门、甚至 TypeScript 类型解析互相绊脚，都是家常便饭。 --- ### 为什么 `folders` 列表里写相对路径却找不到子项目？ 这个问题很常见，踩坑率极高。VSCode 对 `.code-workspace` 文件中 `path` 字段的处理方式，有一个非常容易被忽略的要求：它必须是相对于该文件自身位置的路径。很多人习惯写 `"./packages/ui"`，但如果 `.code-workspace` 文件放在 `~/my-monorepo` 外层，这个相对路径就指向了错误的地方。VSCode 不会报错，只是静默跳过——资源管理器里少一个文件夹，Ctrl+P 也搜不到，排查起来很隐蔽。 需要记住的几件事： - 所有 `path` 都要从 `.code-workspace` 文件所在的目录算起 - 别用 `~`、`${env:HOME}` 或任何环境变量，VSCode 不认 - 路径不存在时，不报错、不提醒，只有你手动去核对 - 最稳妥的做法：统一用绝对路径，比如 `/Users/you/my-monorepo/packages/ui`，一步到位 --- ### `settings` 里怎么避免 ESLint 和 Prettier 在不同子包间打架 多根工作区的 `settings` 是全局合并生效的，这意味着你在顶层 `.code-workspace` 里写的 `"eslint.validate": ["javascript", "typescript"]`，会强行覆盖所有子包。哪怕某个子包用的压根不是 ESLint，甚至用的是 Biome，也无差别地生效。 所以，真正的解法是分治： - 全局禁用 ESLint：在顶层设置中明确 `"eslint.enable": false`，然后让每个子包通过自己的 `.vscode/settings.json` 独立控制是否启用 - 用语言级覆盖替代全局判断：比如只针对 TypeScript 关掉某些格式化规则，不要一刀切 - 不要写 `"editor.tabSize"` 这类通用项——不同子包可能有不同的缩进约定，应该交给各自的 `.editorconfig` 去管 - 真正需要统一的只有 `"files.exclude"` 和 `"search.exclude"`，比如排除所有 `dist` 和 `.turbo` 目录 --- ### 调试时 `launch.json` 怎么按子包隔离启动 多根工作区不会自动合并各子包的 `.vscode/launch.json`。它只会加载当前活动文件所在根目录下的配置。也就是说，如果你在 `packages/api` 里按下 F5，VSCode 不会管 `packages/web` 下的 `launch.json`，更不可能帮你把两个服务串起来跑。 这就是为什么需要手动隔离： - 每个子包必须有自己的 `.vscode/launch.json`，而且 `type` 字段必须精确对应运行时（比如 `"type": "node"` 或 `"type": "pwa-node"`） - 跨子包的复合调试，必须使用 `compounds`，但注意：这个 `compounds` 要定义在顶层 `.code-workspace` 的 `"launch"` 字段下，而不是某个子包的 `launch.json` 里 - `compounds` 中引用的 `configurations`，必须与已存在的命名配置完全一致，大小写敏感 - 别指望 VSCode 能自动识别 `package.json#scripts`，它不读那个。你需要手动写 `runtimeExecutable` 或 `program` 真正的深度隔离，不在 UI 层面，而在配置的粒度：每个子包的 `.vscode/settings.json`、`.vscode/launch.json`、`.prettierrc` 和 `tsconfig.json` 必须独立存在且互不继承。`.code-workspace` 只负责组织路径和极少数全局排除规则。越少往里塞设置，越不容易出问题。