command not found: code说明vs code命令行工具未添加到系统path,需在vs code中执行“shell command: install 'code' command in path”并重启终端验证。

command not found: code 是最常见卡点
终端输入 code . 报错,说明 code 命令根本没注册进系统 PATH。这不是路径写错或权限问题,而是 VS Code 的 CLI 工具压根没启用。
Windows 安装时默认勾选「Add to PATH」,但重装、便携版、或企业策略限制都可能导致它被跳过。别猜,直接验证:
- 打开 CMD 或 PowerShell,运行
code --version—— 有输出就跳过这步;没输出,继续下面操作 - 在已运行的 VS Code 中按
Ctrl+Shift+P,输入Shell Command: Install 'code' command in PATH并执行 - 关掉所有终端窗口,**重新打开一个新的终端**(PATH 变更不会热更新到已有终端)
- 再试
code --version,确认成功
code . 和 code /path/to/folder 的行为差异
code . 是最常用也最容易出错的写法:它只对当前终端工作目录有效,且依赖你是否已 cd 进目标文件夹。而 code /path/to/folder 显式指定路径,不依赖当前位置,更可控。
Windows 路径要注意两件事:
- 用正斜杠
/最省事,比如code C:/Users/me/project,VS Code 内部会自动兼容 - 如果坚持用反斜杠,必须双写:
code C:\Users\me\project,单个在命令行里会被当转义符吃掉 - 路径含空格无需引号 ——
code C:/My Projects/app是合法的,VS Code 自己处理了
避免打开后左侧空白或“No folder opened”提示
即使 code 命令成功执行,也可能只弹出一个空窗口,资源管理器一片空白。这不是命令失败,而是 VS Code 没把该路径识别为“已打开的文件夹”。典型诱因:
- 路径末尾多加了斜杠,比如
code C:/project/(结尾的/有时触发解析异常) - 目标路径是符号链接或网络映射盘(
Z:),某些 VS Code 版本对 UNC 路径支持不稳定 - 该文件夹下没有可识别的项目文件(如
package.json、.git),但其实不影响,只是 UI 提示弱化
验证是否真打开了:看左下角状态栏 —— 如果显示 No folder opened,说明只是开了个编辑器窗口,不是文件夹工作区。此时手动点菜单 File → Open Folder… 补救,或关掉窗口重试 code 命令。
想右键直接打开?别碰注册表手动改
网上流传的 .reg 文件方案看似一劳永逸,但实际风险高:路径写错、引号缺失、6 处替换漏掉 1 处,都会导致右键菜单失效甚至报错。而且 Windows 更新或 VS Code 升级后容易被覆盖。
更稳的做法是用 VS Code 自带功能:
- 确保
code命令已就绪(见第一段) - 在任意文件夹里按住
Shift键,右键空白处,选择在此处打开 PowerShell 窗口(或 CMD) - 输入
code .回车 —— 本质和终端里操作一致,只是路径自动带入
这个组合拳绕过了注册表、不依赖第三方脚本、每次都是干净调用,适合日常高频使用。真正需要右键菜单的场景,反而建议用 WSL 或远程开发插件替代。











