code命令需先通过Shell Command: Install 'code' command in PATH启用,否则报command not found;启用后须新开终端验证,且打开.code-workspace文件必须用完整路径,否则仅显示[Folder]而非[Workspace]。

code 命令必须先启用,否则直接报 command not found: code
这是最常卡住的第一步。VS Code 安装时未必自动注册 code 到系统 PATH,尤其在重装、便携版或企业策略限制下。验证方式很简单:打开终端,运行 code --version。没输出就说明没启用。
启用方法:在已运行的 VS Code 中按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入并执行 Shell Command: Install 'code' command in PATH。关键点是——必须关掉所有已有终端,新开一个再试,PATH 变更不会热加载。
打开 .code-workspace 文件要用完整路径,不能只写文件名
code 命令不支持像 shell 那样自动查找当前目录下的工作区文件。它不会默认扫描 *.code-workspace,也不会把未带路径的文件名当作相对路径处理。
- ✅ 正确:
code my-project.code-workspace(当前目录下存在该文件) - ✅ 正确:
code /home/user/workspaces/backend.code-workspace(绝对路径) - ❌ 错误:
code backend或code backend.code-workspace(当前目录没有这个文件)
路径中含空格无需引号,VS Code 内部已处理;反斜杠需双写(C:\project\ws.code-workspace),但推荐统一用正斜杠(C:/project/ws.code-workspace)更稳妥。
打开后状态栏显示 [Folder] 而不是 [Workspace]?说明没识别成工作区
即使命令执行成功,窗口左下角若显示 [Folder],代表 VS Code 把它当作了单文件夹打开,而非多根工作区配置。常见原因:
- .code-workspace 文件内容损坏或格式非法(比如 JSON 缺少逗号、多出逗号、用了中文引号)
- 文件里
"folders"字段为空数组或路径不存在/不可读 - 你用的是旧版 VS Code(
快速验证:手动点菜单 File → Open Workspace from File… 选同一个文件,如果这次显示 [Workspace],基本可锁定是命令行调用时路径解析异常,优先检查路径拼写和权限。
想一键打开特定工作区?别硬记路径,用任务封装
频繁切换几个固定工作区时,每次输长路径容易错,也难维护。推荐用 VS Code 的 task 功能封装:
在工作区根目录下创建 .vscode/tasks.json,内容类似:
{
"version": "2.0.0",
"tasks": [
{
"label": "open-frontend-ws",
"type": "shell",
"command": "code /full/path/to/frontend.code-workspace",
"group": "build",
"presentation": {
"echo": false,
"reveal": "never",
"focus": false,
"panel": "shared"
}
}
]
}
之后按 Ctrl+Shift+P → Tasks: Run Task → 选 open-frontend-ws 即可。还能进一步绑定快捷键,但要注意:这类任务本质是新开一个 VS Code 实例,不会复用当前窗口——如果要无缝切换,仍得用 workbench.action.openWorkspaceFromFolder 命令 + 快捷键绑定。
真正容易被忽略的是:工作区切换不是“打开即切换”,而是“打开 + 确认复用窗口 + 状态栏出现 [Workspace]”。三者缺一不可,尤其最后一点,很多人以为窗口弹出来了就算成功,其实只是启动了一个新编辑器实例。


















