macOS终端执行code命令报错需在VS Code中运行“Shell Command: Install 'code' command in PATH”并重启终端;Windows需检查PATH是否含VS Code路径,未生效则重装勾选“Add to PATH”;强制新窗口须用code --new-window .。

macOS 终端执行 code 命令报 command not found: code
这不是 VS Code 没装好,而是 Shell 根本不认识 code 这个命令。VS Code 安装后默认不把 CLI 工具写入 PATH,必须手动触发安装逻辑。
唯一可靠做法:在任意已打开的 VS Code 窗口中,按 Cmd+Shift+P 打开命令面板,输入并运行 Shell Command: Install 'code' command in PATH。完成后关闭并重启终端(不是 VS Code),再试 code --new-window .。
别用软链或手改 ~/.zshrc 加 alias——VS Code 官方安装器会根据你当前 Shell 类型(zsh/bash/fish)自动写对配置行,手动干预反而容易因引号、空格、转义出错。
Windows 上 code 命令不可用但安装时勾选了“添加到 PATH”
常见于 Windows 11 + 用户账户控制(UAC)较严的环境:安装程序声称添加了 PATH,但实际只写入了当前用户的环境变量,且未广播给已运行的终端进程。
验证方式:打开新终端(不是已有窗口),执行 echo %PATH%,搜索是否有 Microsoft\VS Code 字样路径;没有就说明没生效。
补救步骤:
- 重新运行 VS Code 安装包(.exe),勾选“Add to PATH”再点“修复”
- 或手动把
C:\Users\<username>\AppData\Local\Programs\Microsoft VS Code\bin</username>加进系统环境变量 PATH - 加完后必须新开一个 CMD/PowerShell/Windows Terminal 窗口,旧窗口不会自动刷新 PATH
code . 总是在旧窗口里打开文件夹,不是新窗口
这是 VS Code 默认的单实例行为,不是 bug。它优先复用已有窗口,除非你明确告诉它“不要复用”。
要强制新窗口,必须加 --new-window 参数:
-
code --new-window .—— 当前目录,干净新窗口 -
code --new-window /path/to/project—— 指定路径,新窗口 -
code --reuse-window .—— 显式要求复用(和code .效果一致)
漏掉 --new-window 就等于没写,点号 . 也不能省——code --new-window 不带路径会启动空窗口,不是当前目录。
想双击桌面图标或 Win+R 输入直接启动特定工作区
VS Code 本身不提供“一键打开 .code-workspace 文件”的全局快捷键,因为工作区是进程级隔离的,每个 .code-workspace 启动的是独立进程,不能靠设置切换。
可行方案只有两个:
- 在桌面建 shell 脚本(macOS/Linux)或批处理(Windows),内容为
code /full/path/to/my.project.code-workspace,赋予可执行权限后双击运行 - Windows 下把
code "C:\path\to\my.project.code-workspace"做成快捷方式(.lnk),右键属性里确认“起始位置”设为该路径所在目录
注意路径必须是绝对路径,相对路径在桌面双击时会以桌面为基准,大概率打不开。


















