code命令需先配置到PATH才能使用:macOS/Linux通过Cmd+Shift+P运行Shell Command安装,Windows安装时须勾选“Add to PATH”,验证执行code --version输出版本号即成功。

code 命令必须先配置到系统 PATH
没配 code 命令,所有命令行操作都走不通。macOS/Linux 需在 VS Code 中按 Cmd+Shift+P(或 Ctrl+Shift+P)运行 Shell Command: Install 'code' command in PATH;Windows 用户检查是否勾选了“Add to PATH”安装选项。验证方式:终端执行 code --version 能输出版本号才算成功。
用 code 打开 .code-workspace 文件即切换工作区
VSCode 不支持命令行“切换”当前已打开窗口的工作区,但能通过 code 命令直接加载指定工作区——这本质是复用已有窗口(若未禁用),而非新开进程。
- 终端执行
code my-project.code-workspace,VSCode 会弹出提示:“是否重用当前窗口?”选“是”,原窗口即加载该工作区,状态栏左下角显示[Workspace] - 若当前无 VSCode 窗口,该命令会启动新实例并加载工作区
- 路径必须准确:
code ./workspaces/backend.code-workspace比code backend.code-workspace更可靠,避免因当前目录偏差导致文件找不到 - 不支持通配符或模糊匹配,
code *.code-workspace会报错或只打开第一个
多窗口场景下,--new-window 是关键参数
想严格隔离项目(比如前端调试和后端日志不能共享终端/断点),就不能依赖“重用窗口”,而要强制新开独立进程。
- 启动全新窗口并加载工作区:
code --new-window my-project.code-workspace - 启动新窗口 + 添加多个文件夹(不生成 .code-workspace):
code --new-window ./frontend ./backend—— 这会创建临时多根工作区,但关闭后不保存,无法复用 - macOS 注意:从 Dock 点击图标默认复用窗口,必须用
--new-window或右键选 “New Window” 才可靠 - Windows/Linux 下
code --new-window后不跟路径,会打开空白窗口;加路径才加载内容
常见错误:误以为 code 可以“切换”已打开窗口的工作区
code 命令没有“向已有窗口发送切换指令”的能力。所谓“切换”,实际是 VSCode 主动检测到同一进程内已有窗口,并询问是否复用。它不会主动把 A 工作区关掉、再加载 B 工作区。
- 现象:执行
code another.code-workspace后,旧标签页还在,但资源管理器只剩新工作区的文件夹 → 说明你点了“否”,开了新窗口,旧窗口被留在后台 - 后果:两个窗口各自运行,内存/CPU 占用翻倍,终端、调试器、扩展状态完全不共享
- 修复方法:关掉多余窗口,或下次执行时注意弹窗提示,务必点“是”
- 更稳妥的做法:提前在设置里关掉自动恢复,设
"window.restoreWindows": "none",避免启动时意外加载上一次的混乱状态
.code-workspace 文件的显式引用和窗口复用策略,而不是命令行“切换”这个动作本身。容易被忽略的一点是:VSCode 是否复用窗口,取决于你点击弹窗时的选择,而不是命令本身——命令只是触发器,决定权始终在用户手上。


















