code命令在终端报“command not found”是因为未加入系统PATH:Windows安装时默认勾选Add to PATH,macOS/Linux需通过VSCode命令面板执行“Shell Command: Install 'code' command in PATH”并重启终端验证。

装完 VSCode 后直接在任意终端里敲 code 就能启动,但前提是它真被加进了系统 PATH——Windows 用户基本没问题,macOS/Linux 用户大概率要手动补一步。
为什么 code 命令在终端里报 “command not found”
不是 VSCode 没装好,而是 shell 根本没“看见”它。Windows 安装器默认勾选 Add to PATH,所以开箱即用;macOS 和 Linux(尤其是 .zip/tar.gz 手动解压、或 Snap 版 Ubuntu)压根不会自动写入 shell 配置文件。
验证方式很简单:which code 如果没输出,就说明 PATH 里没它。
- macOS 上若用 .zip 解压安装,
code二进制实际在/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code,但 VSCode 不会自己把它塞进 PATH - Snap 版 Ubuntu 的 VSCode 被沙盒隔离,
code命令根本不存在——这是设计使然,不是故障 - 即使你改过
~/.zshrc手动加了 PATH,也得新开终端才能生效,只关掉当前终端标签页没用
怎么让 code 命令真正可用
最稳妥的方式是用 VSCode 自带的命令来安装,它会自动判断你的 shell 类型(zsh、bash 或 fish),并往对应配置文件里追加 export PATH 行。
- 打开 VSCode,按
Cmd+Shift+P(macOS)或Ctrl+Shift+P(Windows/Linux)调出命令面板 - 输入
Shell Command: Install 'code' command in PATH,回车执行 - VSCode 会提示“已安装”,并修改你的
~/.zshrc(macOS Catalina+)、~/.bash_profile或~/.profile - 必须关掉所有终端窗口(不只是标签页),再新开一个,运行
code --version确认是否生效
如果仍不生效,检查 VSCode 是否真在默认路径:/Applications/Visual Studio Code.app(macOS)或 /usr/share/code(Linux .deb)。要是你把它拖到了桌面或其它位置,VSCode 可能推导不出 bin 路径,得手动补。
code 命令常见参数和误用点
-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:命令行静默安装扩展,适合脚本化环境初始化
注意:code . 启动的是新窗口,而 code -r . 是复用——但如果你当前没有 VSCode 进程在运行,-r 也照样会起一个新窗口,这点容易误解。
内置终端和 code 命令是两回事
很多人混淆“在 VSCode 里开终端”和“在终端里开 VSCode”。前者是 Ctrl+` 呼出的集成终端,本质是嵌入的 shell(zsh、PowerShell 等);后者是在外部终端(iTerm2、Windows Terminal)里执行 code 命令,把 VSCode “召唤”出来。
内置终端默认以非登录 Shell 启动,不加载 ~/.zshrc,所以 node、nvm 等命令可能找不到——这不是 code 命令的问题,而是终端配置问题。解决方法是改 terminal.integrated.profiles,给 shell 加上 "args": ["-l"],然后彻底重启 VSCode(只关终端无效)。


















