code命令找不到的根本原因是path未配置、注册未触发或安装方式不支持；必须先通过图形界面执行shell command注册并新开终端，再用code --version验证。
code 命令找不到，不是 VSCode 没装上，而是系统压根没“看见”它——PATH 里没路径、注册根本没触发、或者你用的压根就不支持注册。
code --version 报 command not found 怎么办
这是最底层的连通性问题，必须先解决它，后面所有操作才可能生效。
- Windows 用户：检查安装时是否勾选了
Add to PATH；若没勾选，手动把C:\Users\{user}\AppData\Local\Programs\Microsoft VS Code\bin加进系统环境变量PATH - macOS 用户：官网 .dmg 安装后需在已运行的 VS Code 图形界面中执行
Shell Command: Install 'code' command in PATH；.zip 解压版不支持该命令，得手动建软链：sudo ln -s /Applications/Visual Studio Code.app/Contents/Resources/app/bin/code /usr/local/bin/code - Linux 用户：.deb 包通常自带
/usr/bin/code；Snap 版默认不可用，which code无输出就说明没戏，建议换 deb 包 - 验证方式统一：新开终端（不是新标签页），运行
code --version；有输出才算成功
VS Code 图形界面能开，但终端里 code 还是找不到
图形界面和终端启动是两条独立路径，能开 GUI ≠ CLI 可用。常见于 PATH 继承错位或安装方式不兼容。
- 在 VS Code 内置终端里执行
echo $PATH，对比系统终端输出；不一致说明 VS Code 启动时没读取你的 shell 配置（如~/.zshrc） - WSL 用户注意：
code是 Windows 主机命令，在 WSL 的 Linux shell 里直接敲必然失败；要用 Remote - WSL 扩展，再在远程窗口里调code - 便携版/.zip 解压版、Insiders 与 Stable 并存、PATH 被其他软件覆盖——这些情况都会导致
which code无输出 - 别信“集成终端能跑 code 就代表全局可用”，它只继承当前 VS Code 启动时的环境，不能反推系统级注册状态
执行 Shell Command 注册后仍不生效
这个命令看似一键，实则依赖多个前提：VS Code 必须在标准路径、用户有写权限、shell 配置文件可写且未被锁定。
- macOS 上如果 VS Code 不在
/Applications目录（比如拖到了桌面），注册会失败，因为脚本推导不出 bin 路径 - 执行注册后提示成功，但
source ~/.zshrc仍无效？检查该文件末尾是否真追加了export PATH=...行；有时因权限问题写入失败，日志静默丢弃 - 遇到
EACCES: permission denied，先运行Shell Command: Uninstall 'code' command from PATH，再重试安装 - Linux 下若用
sudo code启动过，~/.vscode目录可能属 root，运行sudo chown -R $USER:$USER ~/.vscode修复
真正卡住人的，往往不是“怎么注册”，而是“注册了但没生效”的隐性条件：VS Code 位置不对、shell 配置被跳过、权限被锁死、或压根用了 Snap/.zip 这类不支持注册的安装包。验证永远从 which code 和新开终端开始，别在旧终端里反复试。
