在 macOS 上用 VS Code 管理多项目需创建 .code-workspace 文件，显式通过命令面板新建、多选根目录、保存为相对路径配置；工作区设置仅覆盖指定项，敏感信息不提交；支持双击、终端 code 命令、命令面板快速打开；注意左下角标识、launch.json 位置及扩展作用域。
在 macos 上用 vs code 管理和切换不同工作区，核心是靠 .code-workspace 文件统一聚合项目、固化配置，并配合系统级快捷操作实现真正“秒开秒切”。不需要开多个窗口，也不依赖记忆路径。
创建可靠的工作区文件
别用拖拽或“添加到工作区”临时拼凑——那样不会生成可复用的配置。必须显式创建并保存：
- 启动 VS Code（确保是空窗口，没打开任何文件夹）
- 按 Cmd+Shift+P 打开命令面板，输入 Workspaces: Create Workspace 并回车
- 在弹出的文件选择框中，按住 Cmd 多选多个项目根目录（如
./frontend、./backend） - 保存为
my-project.code-workspace，建议放在这些项目的共同父目录下，路径用相对路径（如"path": "../backend"）
让配置既安全又灵活
工作区级设置（.code-workspace 中的 "settings"）只覆盖你明确写的字段，其余仍由各项目自己的 .vscode/settings.json 控制：
- 想统一禁用某类文件搜索？在
.code-workspace里写"search.exclude": {"**/dist": true} - Python 解释器别硬编码路径，右下角点击 Python 版本，直接选对应 venv
- 敏感项（如密钥、本地路径）一律不提交到 Git；团队共享时只保留通用规则（缩进、自动保存等）
快速切换的三种实用方式
不用翻菜单，也不用记路径：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
-
双击打开：Finder 中直接双击
.code-workspace文件，VS Code 自动全量加载 -
终端直启：在任意终端执行
code my-project.code-workspace（需先运行Shell Command: Install 'code' command in PATH） - 命令面板速搜：按 Cmd+Shift+P → 输入 Workspaces: Open Recent，列表里会显示所有已保存的工作区（不是单文件夹）
避免常见陷阱
很多“切换失败”其实源于状态混淆：
- 左下角没有 [Workspace] 标识？说明当前仍是单文件夹模式，不是多根工作区
- 调试不生效？确认
.vscode/launch.json放在.code-workspace同级目录，且每个configuration中"cwd"指向正确的workspaceFolder:name - 扩展没启用？VS Code 不自动按工作区开关插件，需手动进入 Extensions 视图，点击右上角齿轮 → “Configure Extension Settings” → 设为“Workspace”范围
