code命令无反应需先运行code --version验证,若报错则需通过Shell Command: Install 'code' command in PATH注册;code .默认复用窗口,新开窗口须加--new-window;打开.code-workspace文件直接传路径即可;添加文件夹到多根工作区用--add参数。

code 命令根本没反应?先确认 CLI 是否注册
执行 code --version 是最直接的验证方式。如果报错 command not found: code,说明 VS Code 的命令行工具压根没注册进系统 PATH —— 这不是路径写错了,也不是权限问题,而是功能根本没启用。
解决方法唯一:在任意已打开的 VS Code 窗口中按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入并运行 Shell Command: Install 'code' command in PATH;然后关闭所有终端窗口,**重新打开一个新终端**再试。
macOS 用户尤其注意:即使 VS Code 已安装,code 命令默认也不可用;Windows 用户若用便携版、企业策略禁用或重装时跳过了勾选,也会遇到同样问题。
启动单文件夹工作区:code . 不等于“新开窗口”
code . 默认复用已有窗口,这是 VS Code 的单实例行为,不是 bug,但容易误以为“启动失败”。要真正打开一个干净的新窗口并加载当前目录,必须加 --new-window。
- 正确写法只有这一种:
code --new-window . -
--new-window不可省略,漏掉就等于没写 - 点号
.表示当前目录,也不能省;换成空格或留空会导致打开空白窗口 - 路径末尾多加斜杠(如
code /project/)可能触发解析异常,资源管理器为空
常见错误现象:code . 执行后,目标文件夹被塞进已有窗口的资源管理器里,左下角仍显示 “No folder opened” 或上一个工作区路径 —— 这就是没加 --new-window 的典型表现。
打开已保存的 .code-workspace 文件:直接传路径即可
工作区文件本质是一个 JSON 配置,后缀为 .code-workspace(如 my-app.code-workspace)。它不依赖当前终端位置,只要路径对,就能准确加载多根结构、设置、任务和调试配置。
操作方式很简单:
- 终端中执行:
code my-app.code-workspace - 路径含空格无需引号:
code Projects/my app.code-workspace合法且有效 - 路径用正斜杠更稳妥(Windows/macOS 通用):
code C:/dev/my-app.code-workspace - 避免反斜杠单写:
code C:\dev\my-app.code-workspace中单个\d可能被 shell 当转义符吃掉
注意:这个命令不会自动加 --new-window,如果想强制新开,得显式加上:code --new-window my-app.code-workspace。
向已有窗口添加文件夹构建多根工作区:用 --add
如果你已经开着一个 VS Code 窗口,并希望把另一个项目目录加入当前工作区(变成多根),不能靠 code /path/to/folder,那会打开新窗口或复用但只加载单个文件夹。
正确做法是用 --add 参数:
-
code --add /path/to/backend:将 backend 目录加入上一个活动窗口的工作区 -
code --add /path/to/frontend /path/to/docs:一次添加多个文件夹 - 该操作仅对“当前已有工作区”的窗口生效;若当前是空白窗口或单文件模式,
--add会被忽略 - 添加后不会自动保存为
.code-workspace文件;如需持久化,仍需通过菜单File > Save Workspace As...
容易被忽略的一点:多根工作区的配置(比如 settings.json)只存在于工作区文件中,不在任一子文件夹的 .vscode/ 下 —— 这意味着你不能靠复制粘贴某个子项目的 .vscode 来迁移整个工作区行为。


















