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] —— 这是唯一可信启用标志

资源管理器里右键“添加文件夹”是个高危操作

这个菜单项看似便捷，但极易引入不可控状态：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 它会直接修改当前 .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 空格 —— 别指望靠手写注释来维护说明，逻辑必须靠结构本身表达清楚。