code命令未注册path是根本原因，必须通过vs code图形界面执行“shell command: install 'code' command in path”并重启终端验证；手动补路径仅作备用且风险高。
code 命令根本没注册进系统 PATH，不是装错了，而是“系统不认识它”——必须显式触发注册或手动补路径，否则所有后续操作都无效。
code --version 报 command not found 怎么办
这是最底层的连通性问题，说明 shell 完全找不到 code 可执行文件。别试 code . 或插件安装，先解决这个。
- Windows 用户：检查安装时是否勾选了 “Add to PATH”；若用的是便携版、.zip 解压版或企业策略禁用，该选项根本不会出现，
code.cmd就不会写入C:\Users\{user}\AppData\Local\Programs\Microsoft VS Code\bin - macOS 用户：官网 .dmg 拖入
/Applications后，默认也不注册；.zip 解压版更不会自动处理，code二进制实际在/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code - Linux 用户：Snap/Flatpak 版本默认不可用；.deb 包通常自带
/usr/bin/code，但 PATH 可能未包含该路径；.tar.gz 解压版需手动软链或改$PATH - 验证方式统一：终端运行
which code，无输出即确认缺失；不要依赖 VS Code 内置终端是否能跑，它可能继承了错误的 PATH
必须通过 GUI 触发 Shell Command 注册
这是唯一官方支持、且对大多数用户真正生效的方式。命令面板里的 Shell Command: Install 'code' command in PATH 不是装饰，它会根据你的 shell 类型（zsh/bash/fish）自动往对应配置文件里追加 export PATH=...。
- 打开任意已运行的 VS Code 图形窗口（不能只开集成终端）
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）调出命令面板 - 输入并执行
Shell Command: Install 'code' command in PATH - 关闭**所有终端应用窗口**（不只是标签页），再新开一个终端 —— PATH 变更不会热更新到已有会话
- 此时再运行
code --version，有输出才算成功；若仍失败，说明你用的是不支持该功能的安装包（如 Snap、.zip 未运行 installer）
手动补 PATH 的适用场景与风险
当 Shell Command 灰显不可用、或你明确知道 VS Code 装在非标准路径时，才考虑手动处理。操作不当容易引发权限或路径解析错误。
- macOS 手动添加：编辑
~/.zshrc（Catalina 及以后默认），末尾加一行：export PATH="/Applications/Visual Studio Code.app/Contents/Resources/app/bin:$PATH" - Windows 手动添加：把
C:\Users\{user}\AppData\Local\Programs\Microsoft VS Code\bin加入系统环境变量 PATH（注意是“系统变量”还是“用户变量”，普通用户选后者） - Linux（.tar.gz）手动软链：
sudo ln -s /path/to/VSCode-linux-x64/bin/code /usr/local/bin/code，确保目标路径可执行且属当前用户 - 切记不要用
sudo code --install-extension：这会让插件装到/root/.vscode/extensions/，普通用户启动 VS Code 后完全不可见
为什么重开终端后还是不行
常见于路径推导失败、权限错位或多版本冲突，不是注册流程本身的问题。
- VS Code 被挪动过位置（比如从 Downloads 拖进 Applications 后没重新注册）：
Shell Command会基于当前code实际路径生成软链，路径一变就失效 - 用户数据目录权限异常：Windows 上
%APPDATA%\Code、macOS 上~/Library/Application Support/Code若属root或设为只读，会导致注册脚本静默失败 - 同时装了 Stable 和 Insiders：PATH 可能指向旧版本的
bin目录，而新版本已卸载；运行ls -l $(which code)（macOS/Linux）或where code（Windows CMD）确认真实路径 - PowerShell 执行策略限制：运行
Get-ExecutionPolicy，若为Restricted，需临时设为RemoteSigned才能加载 PATH 修改
真正卡住的地方往往不是“怎么注册”，而是“注册完 PATH 是否真的被 shell 读取”——很多用户关了终端又重开，却忘了自己用的是 zsh 而配置改在了 .bash_profile 里，或者用了 WSL 却在 Linux shell 里硬调 Windows 的 code.cmd。路径、shell、权限，三者缺一不可。
