VS Code 怎么在一个窗口打开多个项目文件夹

如果两个项目需要同时对照编辑，不必开两个 VS Code 窗口。打开一个项目后，使用 File > Add Folder to Workspace 把另一个目录加入当前窗口，Explorer 就会显示两个并列的根目录。最后执行 File > Save Workspace As... 保存为 .code-workspace 文件，下次可以直接恢复这组目录。

先确认单项目窗口和使用边界

先在 VS Code 中打开第一个项目，例如 orders-api。如果 Explorer 顶部只显示一个项目根目录，此时还是单文件夹模式。多根工作区更适合有明确关联的目录，例如后端代码和运维文档；完全无关的项目混在一起，会让搜索、任务和 Git 仓库列表变得难以判断。

本次示例准备两个目录：orders-api 和 ops-docs。它们可以是同一父目录下的兄弟目录，也可以位于不同位置。加入工作区不会把文件复制或移动到一起，只是让 VS Code 在一个窗口里管理多个根目录。

通过 Add Folder to Workspace 加入第二个项目

1. 打开添加入口：点击顶部菜单 File，选择 Add Folder to Workspace...。在文件选择器中选中第二个项目目录，再点击打开。
2. 检查根节点：回到 Explorer，确认 orders-api 和 ops-docs 处在同一级，而不是把第二个目录展开成第一个目录里的子文件夹。
3. 确认文件归属：分别展开两个根节点，从各自目录打开文件。编辑器标签、Quick Open 和搜索结果会使用文件所属的根目录帮助区分同名文件。

也可以把多个目录拖到 Explorer，或用命令行把目录加入最近活动的 VS Code 实例：code --add orders-api ops-docs。命令行方式适合已经在脚本或项目目录中定位好路径的场景；手动菜单更适合第一次配置。

保存为可复用的 .code-workspace 文件

1. 打开保存命令：点击 File > Save Workspace As...，选择团队方便访问的位置，输入例如 team.code-workspace。
2. 核对保存结果：保存后，窗口标题或最近打开列表会出现工作区名称，目录旁会有工作区文件。这个文件记录的是 folders 列表，并不打包项目源码。
3. 重新打开：以后可双击该文件，或使用 File > Open Workspace。如果用 File > Open Recent，带有 (Workspace) 后缀的条目就是工作区入口。

如果工作区文件需要提交到 Git，目录路径建议使用相对路径，例如 ./orders-api 和 ./ops-docs，这样团队成员把仓库放到不同位置时仍能打开。VS Code 也允许在工作区文件里放全局设置和扩展推荐，但文件夹级设置仍应留在各项目自己的 .vscode 目录中，避免把项目配置混成一份。

两个项目同时打开时怎么排查异常

临时协作时可以不保存工作区；但未保存的 UNTITLED WORKSPACE 只在当前 VS Code 实例存活期间存在，完全关闭后若要再次使用，仍需要按提示保存。要回到单项目模式，可以关闭工作区后重新打开某一个文件夹，或者从根目录右键菜单移除其他文件夹。

常见问题

多根工作区会把两个项目合并吗？

不会。它只是把多个目录挂到同一个 VS Code 窗口，文件仍保留在原来的磁盘位置，Git 仓库也按各自根目录显示。

工作区文件应该放在哪里？

放在团队都能访问、且相对路径稳定的位置即可。若要提交到仓库，通常和这些项目目录处在可解释的父级位置，并在提交前打开文件确认 folders 路径。

怎样只搜索其中一个项目？

使用全局搜索的 Files to include 字段，在路径前加 ./ 和根目录名，例如 ./ops-docs/**/*.md。

最短操作链就是：先打开一个目录，执行 File > Add Folder to Workspace...，确认 Explorer 出现多个根节点，再用 File > Save Workspace As... 保存。把这个工作区文件交给团队后，大家打开的是同一组目录关系，而不是一份复制出来的项目。