code命令默认不可用，因VS Code安装后未自动注册到系统PATH；需通过图形界面执行“Shell Command: Install 'code' command in PATH”并重启终端来启用。
code 命令默认不可用，不是你装错了，是它根本没进系统 PATH。 安装完 VS Code 后直接在终端输 code --version 报 “command not found”，99% 是这个原因，不是环境变量污染或 shell 配置问题。
为什么 code 命令找不到？
VS Code 官方安装包（.exe、.dmg、deb）自带一个 shell 包装器脚本，但不会自动注册到系统 PATH。Windows 安装时若没勾选 “Add to PATH”，macOS/Linux 没手动触发注册，code 就只是个藏在应用包里的文件，终端根本看不见。
- macOS：包装器路径为
/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code，但终端不认 - Linux（Snap/Flatpak 版）：不提供
code命令，该命令只存在于官方 .deb/.rpm 或 tar.gz（含 bin/ 目录）版本中 - Windows：若安装时漏选 “Add to PATH”，就得手动把
C:\Users\{user}\AppData\Local\Programs\Microsoft VS Code\bin加进系统或用户环境变量
如何正确启用 code 命令？
唯一可靠方式是通过 VS Code 图形界面触发注册，不是改 shell 配置文件，也不是软链接——那是绕过机制的临时补丁，容易失效。
- 启动 VS Code 图形界面（双击图标或从开始菜单打开）
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），打开命令面板 - 输入
Shell Command: Install 'code' command in PATH，回车执行 - 关闭所有终端窗口，新开一个，再运行
code --version验证
注意：该操作仅对当前用户生效；若用的是管理员账户安装、却以普通用户登录，得用对应用户重复执行一次。
code 启动参数避坑指南
参数用错会导致窗口闪退、打不开目录、阻塞脚本等现象，常见误用集中在路径处理和窗口复用逻辑上。
-
code .在 Windows 上路径含空格或中文时会失败 → 改用code ".\my project"或code "$(pwd)" -
code默认每次新建窗口 → 用code -r .复用已有窗口，避免项目越开越多 - 写自动化脚本（如 Git hook、Makefile）时需等待编辑器关闭 → 加
-w参数：code -w myfile.js - 在 cron、systemd 或无 GUI 环境调用会失败 → 改用
code --list-extensions这类纯 CLI 命令，或确保 DISPLAY/X11 环境就绪
非官方安装版怎么办？
如果你用的是 .zip 解压版、Snap、Flatpak 或某些 Linux 发行版仓库源安装的 VS Code，Shell Command: Install 'code' command in PATH 选项大概率灰显不可用——因为这些版本没打包那个 shell 包装器。
- .zip 版：手动把解压目录下的
bin/code软链接到/usr/local/bin/code（需 sudo），或加进$PATH - Snap 版：可用
snap run code替代，但无法支持-r、-w等部分参数 - 最省事方案：卸载，改用官网下载的 .deb（Debian/Ubuntu）、.rpm（Fedora/RHEL）或 .tar.gz（通用 Linux）
真正容易被忽略的是：即使 code 命令能执行，code -r 在多用户或远程 SSH 场景下也可能复用失败——它依赖 VS Code 的 IPC socket 文件，默认只对同一用户、同一 session 有效。
