VSCode 的 code 命令未识别是因 PATH 未配置,需通过命令面板执行“Shell Command: Install 'code' command in PATH”并重启终端验证;Snap 版不支持该命令,须改用 .deb 安装。

code 命令根本没出现在终端里?先确认是不是 PATH 没配好
终端输入 which code,没输出就说明系统压根不认识这个命令——这不是 VSCode 没装好,而是它没被加进环境变量。Windows 安装器默认勾选“添加到 PATH”,所以多数人开箱即用;macOS 和 Linux(尤其是 .zip / tar.gz 解压安装、或 Snap 版 Ubuntu)则完全不会自动写入 shell 配置。
Shell Command: Install 'code' command in PATH 是唯一靠谱方式
VSCode 自带的内置命令会自动识别你的 shell 类型(zsh、bash 或 fish),并往对应配置文件(如 ~/.zshrc、~/.bash_profile)末尾追加一行 export PATH。操作步骤很直接:
- 打开 VSCode,按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)调出命令面板 - 输入
Shell Command: Install 'code' command in PATH,回车执行 - 关闭所有已打开的终端窗口,重新开一个,再运行
code --version验证
如果仍不生效,检查 VSCode 是否在标准路径:/Applications/Visual Studio Code.app(macOS)或 /usr/share/code(Linux .deb)。要是你把它拖到了桌面或自定义目录,VSCode 可能推导不出 bin 路径,得手动补。
别把 code -r 当成重载配置,它只控制窗口复用
-r 等价于 --reuse-window,意思是“已有窗口就复用,别开新窗”。改完 settings.json 想立刻生效?不是敲 code -r .,而是按 Cmd+Shift+P → 输入 Developer: Reload Window 才对。
其他实用但容易忽略的参数:
-
code --goto file.ts:12:5:直接跳转到第 12 行第 5 列,比鼠标快得多 -
code --disable-extensions .:临时禁用所有扩展,排查插件是否导致卡顿或崩溃 -
code --install-extension ms-python.python:命令行静默安装扩展,适合脚本化初始化
Ubuntu Snap 版 VSCode 根本不提供 code 命令
Snap 包被沙盒隔离,code 二进制不可见,也无法通过上述命令安装。解决办法只有两个:snap remove code,然后去官网下 .deb 包重装;或者用 sudo snap alias code vscode-code(部分版本支持,但不稳定)。别指望它能和 Git、npm 等工具链无缝配合——这是设计限制,不是配置问题。
最常被忽略的点:PATH 写入成功后,必须新开终端;VSCode 启动时读取的是当前 shell 的环境,不是你编辑完配置文件那一刻的快照。


















