vscode原生多文件夹工作区优于project manager等插件，因其直接支持.settings同步、全局搜索及跨项目调试；正确做法是用code .启动后添加文件夹并另存为.code-workspace，确保路径为相对路径、设置分层合理、无重复条目。
VSCode 本身不依赖插件就能管理多个项目文件夹——核心能力是原生的「多文件夹工作区」，所谓“项目管理插件”大多是画蛇添足，甚至引入路径混乱、自动重命名冲突、保存逻辑覆盖等新问题。
为什么不用 Project Manager 这类插件
这类插件（如 alefragnani.project-manager）本质是用独立 JSON 文件维护项目快捷入口，但它绕过了 VSCode 原生的 .code-workspace 机制，导致：
- 无法同步工作区级设置（比如跨项目的
search.exclude或调试launch.json） - 点击插件列表打开的仍是单文件夹模式，不是真正的工作区，
Ctrl+Shift+F全局搜索只扫当前文件夹 - 插件自建的路径缓存容易过期：重命名/移动文件夹后不更新，点击就报
Error: Unable to resolve non-existing folder - 和团队协作脱节——你分享一个
.code-workspace文件，别人开箱即用；分享插件配置，还得教人装插件、导入 JSON、校验路径
code . 启动 + .code-workspace 保存才是正解
自由职业者常同时处理 3–5 个客户项目，关键不是“快速切换”，而是“一次配置，长期稳定”。直接用 VSCode 原生命令：
VSCode 1.118
下载
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
- 终端进入主项目目录（比如
~/clients/acme-frontend），运行code .——这会以该文件夹为起点启动工作区 - 菜单栏点
文件 → 将文件夹添加到工作区，依次加入../acme-backend、../acme-shared - 立刻点
文件 → 将工作区另存为，存为acme-fullstack.code-workspace（建议放在~/workspaces/统一管理） - 下次双击这个
.code-workspace文件，或终端执行code ~/workspaces/acme-fullstack.code-workspace，所有文件夹、设置、调试配置原样恢复
工作区 JSON 里必须手动检查的三项
打开 .code-workspace 文件，别信“添加完就完事”。重点看这三处是否合理：
-
"path"值必须是相对路径（相对于.code-workspace文件所在位置），例如"path": "../backend"。绝对路径（/Users/you/project）换电脑就失效 -
"settings"块里避免写项目专属配置（如 Python 解释器路径），这类应放在各项目自己的.vscode/settings.json中，否则会污染其他项目 - 确认没有重复的
"path"条目——右键资源管理器里某个文件夹点“添加到工作区”可能悄悄加了两遍，导致同名节点并存，编辑时易误操作
真正麻烦的从来不是“怎么加文件夹”，而是加完后没保存 .code-workspace、路径写死、设置堆错层级——这些错误不会报红，但会在两周后某次重装系统或交接代码时突然爆发。
