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

VSCode 本身不能用命令行“安装”,但它的插件和 CLI 工具 code 可以——很多人问的其实是后者。
为什么 code 命令在终端里报 “command not found”
这不是 VSCode 没装好,而是系统根本没把它的可执行文件路径加进 PATH。Windows 安装器默认勾选“Add to PATH”,所以多数人开箱即用;macOS 和 Linux 就不是这样了:
- macOS 上用 .zip 解压安装、或 Linux 用
.tar.gz手动解压的用户,code二进制压根不会自动写入 shell 配置 - Snap 版 Ubuntu 自带的 VSCode 也不提供
code命令——它被沙盒隔离了 - 验证方式很简单:终端里运行
which code,没输出就说明 PATH 里没它
如何通过 VSCode 内置命令安装 code
这是最稳妥、官方推荐的方式。VSCode 会自己判断你的 shell 类型(zsh、bash 或 fish),并往对应配置文件里追加一行 export PATH:
- 打开 VSCode,按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)调出命令面板 - 输入
Shell Command: Install 'code' command in PATH,回车执行 - VSCode 会提示“已安装”,然后修改你的
~/.zshrc(macOS Catalina+)、~/.bash_profile或~/.profile - 关掉所有终端窗口,重新打开一个,再运行
code --version确认是否生效
手动补 PATH 的几种常见场景
如果上面方法不生效,大概率是 VSCode 没法自动推导 bin 路径——比如你把它拖到了桌面或非标准位置:
- macOS:检查 VSCode 是否真在
/Applications/Visual Studio Code.app;如果不是,得手动补:export PATH="/Applications/Visual Studio Code.app/Contents/Resources/app/bin:$PATH" - Linux(.deb 安装):路径通常是
/usr/share/code/bin,加到~/.bashrc或~/.zshrc末尾 - Linux(Snap 版):不支持
code命令,换用sudo snap remove code卸载,改用官网 .deb 包 - 改完配置后别忘了
source ~/.zshrc(或对应文件),再验证which code
真正容易被忽略的是:VSCode 启动时会读取当前 shell 的环境变量,但很多终端(尤其是 GUI 启动的)并不会加载 ~/.zshrc,而是只加载 ~/.zprofile 或 ~/.profile——这时候光改 ~/.zshrc 是没用的。


















