code命令在终端报“command not found”是因为未加入系统PATH：Windows安装时默认勾选Add to PATH，macOS/Linux需通过VSCode命令面板执行“Shell Command: Install 'code' command in PATH”并重启终端验证。
code 命令没出现在终端里，不是 VSCode 没装好，而是它根本没被系统“认识”——必须手动把 code 加进 PATH。
为什么 code 命令在终端里报 “command not found”
Windows 安装器默认勾选“添加到 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确认是否生效
如果仍不生效，检查 VSCode 是否真在默认路径：/Applications/Visual Studio Code.app（macOS）或 /usr/share/code（Linux .deb）。要是你把它拖到了桌面或其它位置，VSCode 可能推导不出 bin 路径，得手动补。
code 命令常见误用和参数陷阱
很多人以为 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：命令行静默安装扩展，适合脚本化环境初始化
macOS 提示“安装命令行开发工具”的真正原因
这个弹窗和 code 命令无关，是 Python、C/C++ 或 Git 插件在调用底层编译器或 git 时触发的——它们依赖 Xcode Command Line Tools（CLT）。VSCode 本身不提供 CLT，它只是检测到缺失后友好提醒。
解决方法是终端运行：
sudo xcode-select --install
装完后执行：
sudo xcode-select --switch /Library/Developer/CommandLineTools
注意：M1/M2 Mac 不要装完整 Xcode（几十 GB），只装 CLT 就够了。装完再开 VSCode，那个弹窗就不会再跳了。
