VS Code 通过 .code-workspace 文件实现多项目工作区管理：可添加多个文件夹、共享搜索与调试配置，需区分项目级与工作区级设置，推荐使用相对路径并避免绝对路径硬编码。
VS Code 本身不提供传统 IDE 那种“多项目工作区”的内置概念，但通过
（工作区）机制，完全可以高效管理多个项目——关键不是打开多个窗口，而是用好
文件。
用
合并多个项目目录
这是最直接、最常用的方式：启动 VS Code 后，先打开一个项目文件夹，再通过菜单添加其他独立项目目录。所有路径会汇总到当前工作区，资源管理器里显示为并列根节点。
每个添加的文件夹保持自身
和
独立生效
搜索（
）默认跨所有已添加文件夹，可右上角点击文件夹图标缩小范围
调试配置（
）需在
下统一维护，不同项目建议用
数组区分，并设置
和
路径指向对应项目
注意：如果两个项目有同名文件（比如都叫
），标签页标题仅显示文件名，容易混淆——建议开启设置
改为
或
显示相对路径
保存为
文件复用配置
临时合并的文件夹不会自动保存。必须手动执行
，生成一个 JSON 格式的
文件。这才是真正可共享、可版本控制的多项目入口。
该文件本质是 JSON，可手写编辑，支持
（路径列表）、
（覆盖全局设置）、
（推荐扩展）、
和
（调试与任务）等字段
路径支持相对写法（如
），但只相对于 workspace 文件所在目录；绝对路径（如
）更稳妥，尤其跨机器时
不要把
提交到公共仓库时硬
编码
本地绝对路径；团队协作建议用相对路径 + 统一目录结构约定
避免误用「多窗口」代替「多文件夹工作区」
新手常为每个项目开一个 VS Code 窗口，看似简单，实则丢失协同能力：无法跨项目搜索、跳转、统一调试、共享终端标签页，且内存占用翻倍。
关闭多余窗口前，先确认是否真需要隔离——比如
前端
和后端项目共用一套 API 类型定义，放同一工作区才能享受 TypeScript 的跨文件夹类型推导
若确实需隔离（如生产环境 vs 开发环境配置冲突），可用 VS Code 的「多用户数据目录」机制：
启动独立实例，但这是重量级方案，日常不推荐
快捷键
（Windows/Linux）或
（
mac
OS）可快速打开已有
文件，比反复找文件夹快得多
真正麻烦的不是怎么加文件夹，而是搞清哪些配置该放在工作区级、哪些该留在项目级；还有路径引用一旦写死，换电脑就打不开——这些细节比操作步骤更容易拖慢节奏。
workspace.code-workspaceFile > Add Folder to Workspace….vscode/settings.jsontasks.jsonCtrl+Shift+Flaunch.json.vscode/configurationscwdprogramindex.ts"workbench.editor.labelFormat": "short""medium""long".code-workspaceFile > Save Workspace As….code-workspacefolderssettingsextensionslaunchtasks"./backend""path": "/Users/me/project/frontend".code-workspacecode --user-data-dir=/tmp/vscode-prodCtrl+K Ctrl+OCmd+K Cmd+O.code-workspace