VSCode官方推荐通过.code-workspace工作区管理多项目，它以JSON格式定义多个文件夹、专属配置、扩展和调试设置，支持跨文件夹跳转、统一搜索与共享任务，优先级高于用户和文件夹级设置。
vscode 本身不支持传统意义上的“多项目并行打开多个独立窗口并统一管理”，但通过 workspace（工作区）机制，可以一次性加载多个文件夹、设置项目专属配置、调试和扩展行为——这才是官方推荐且真正可靠的多项目管理方式。
什么是 .code-workspace 文件？
它是一个 JSON 格式的配置文件，定义了哪些文件夹属于当前工作区、各文件夹的别名、推荐扩展、任务配置、调试配置等。不是简单地“同时打开几个文件夹”，而是把它们组织成一个逻辑整体。
- 手动创建：在 VSCode 中通过
File > Add Folder to Workspace...添加多个文件夹后，选择File > Save Workspace As...即生成.code-workspace文件 - 该文件可提交到 Git（建议提交），团队成员用它打开一致的工作区结构
- 直接双击或用
code my-project.code-workspace命令打开，VSCode 会还原所有已添加的文件夹和设置 - 注意：不要把
.vscode/放在某个子文件夹里再期望它影响整个工作区——只有根级.vscode/（即工作区目录下）或.code-workspace内的settings字段才对整个工作区生效
如何为不同项目启用独立的扩展和设置？
VSCode 的扩展默认是全局启用的，但你可以按工作区禁用某些扩展，避免干扰；设置也支持三层优先级：用户级 settings.json → 工作区级 .vscode/settings.json → .code-workspace 中的 settings 字段。后者优先级最高，且只作用于该工作区。
- 在
.code-workspace文件中添加"settings"字段，例如：{ "folders": [{ "path": "backend" }, { "path": "frontend" }], "settings": { "editor.tabSize": 2, "eslint.enable": true, "python.defaultInterpreterPath": "./backend/venv/bin/python" } } - 用
Extensions视图右键某个扩展 →Disable (Workspace)，该扩展将不会在此工作区激活 - 如果某项目需要完全隔离（比如 Python 2 vs Python 3、Node 14 vs Node 18），建议拆分成两个独立的
.code-workspace文件，而不是硬塞进一个
为什么不能直接用多个窗口替代工作区？
看似能开多个 VSCode 窗口分别打开不同项目，但这样会丢失跨文件夹的符号跳转、统一搜索（Ctrl+Shift+F）、共享调试配置、任务编排等关键能力。更重要的是，每个窗口都独立加载扩展和语言服务，内存占用翻倍，且无法复用同一套工作区级设置。
- 例如：你在
frontend文件夹里按F12跳转到shared-utils包的源码——如果这两个不在同一个工作区，VSCode 默认找不到定义（除非你手动配置jsconfig.json或tsconfig.json的paths，但那属于补救，不是设计初衷） - 调试时，一个
launch.json可以同时启动前端 dev server 和后端 API，前提是它们都在同一工作区下 - 终端（
Ctrl+`）默认继承工作区根路径，而非当前打开文件的路径；若没工作区，终端位置不可控
真正麻烦的不是创建工作区，而是搞混「文件夹级设置」「工作区级设置」和「用户级设置」的生效范围。尤其当多个项目共用一个 .vscode/settings.json 但又依赖不同 lint 规则时，最容易误删或覆盖配置。建议始终从 .code-workspace 入手，把项目边界划清楚。
