VSCode多项目管理必须使用保存的.code-workspace文件。直接拖入或“添加文件夹”不持久，全局搜索、终端、调试均失效；需从空窗口创建并保存工作区，配置cwd和路径名严格匹配，设置分层级生效。
VSCode 本身没有叫“开发者工具”的独立面板来管理项目资源——你真正需要的是工作区（.code-workspace）+ 资源管理器 + 正确的配置层级，三者配合才能稳定、可复现地管理多项目资源。
为什么直接拖文件夹或反复“打开文件夹”会丢配置
VSCode 的资源管理器显示多个文件夹 ≠ 多项目已纳入统一管理。临时拖入或通过“添加文件夹到工作区”操作，只是视觉合并，不生成持久化状态：
- 关闭窗口后，所有添加的文件夹全部丢失，下次得重来
-
Ctrl+Shift+F全局搜索不会跨文件夹生效（除非已保存为工作区） - 终端默认路径仍是第一个打开的文件夹，不是你当前编辑的文件所在项目
- 调试时
launch.json不会自动识别不同项目的cwd，容易跑错环境
创建真正能存住的多根工作区：必须从空窗口开始
唯一可靠路径是显式创建并保存 .code-workspace 文件。这不是“可选项”，而是设计硬约束：
- 启动 VSCode 空窗口（状态栏显示
No folder opened） -
Ctrl+Shift+P→ 输入Workspaces: Create Workspace from Folder - 按住
Ctrl（Windows/Linux）或多选（macOS），选中所有项目根目录（如./backend,./frontend,../shared） - 保存为相对路径的
my-team.code-workspace（推荐放在所有项目共同父目录下） - 保存后检查状态栏是否显示
[Workspace]—— 这是唯一可信启用标志
资源管理器里右键“添加文件夹”是个高危操作
这个菜单项看似便捷，但极易引入不可控状态：
- 它会直接修改当前
.code-workspace文件，但不校验路径是否存在 → 下次打开报错Unable to resolve non-existing folder - 用
./projects/foo这类相对路径，换机器或共享给同事时立即失效 - 重复添加同一文件夹，资源管理器出现两个同名节点，实际指向同一份代码，删错一个就误伤
- 添加后不手动
File > Save Workspace，关闭即丢失 —— VSCode 不会自动保存变更
调试和终端行为取决于 .code-workspace 是否存在且配置正确
很多“跨项目跳转失败”“终端命令找不到”“断点不触发”的问题，根源都在这里：
-
launch.json必须放在.code-workspace所在目录的.vscode/下，不能放在子项目内部 - 每个
configuration必须写明"cwd": "${workspaceFolder:backend}"，其中backend必须和folders数组里"path": "./backend"的最后一级目录名完全一致 - 终端默认工作目录是第一个
folders条目，想切到其他项目？右键对应文件夹 →Open in Integrated Terminal -
files.exclude这类设置一旦写进.code-workspace，就全局生效；但python.defaultInterpreterPath这种语言专属配置，仍需写在对应项目的.vscode/settings.json里才有效
最常被忽略的一点：手动编辑 .code-workspace 后保存，所有注释会被清空，缩进强制变成 2 空格 —— 别指望靠手写注释来维护说明，逻辑必须靠结构本身表达清楚。
