必须把code命令加进系统PATH，否则终端无法发现；macOS用VSCode内置命令注册最可靠，Windows需确认bin路径正确并重启终端，Linux应修改PATH而非alias，所有平台均需新开终端验证。
必须把 code 命令加进系统 PATH，否则终端根本找不到它。 这不是 VSCode 自己“开个开关”就能解决的事，而是操作系统层面的可执行文件发现机制问题。没加 PATH，code 就只是 VSCode 安装目录里一个普通文件，终端不会主动去翻它。
macOS 上最稳的安装方式：用 VSCode 内置命令注册
VSCode 自带的注册逻辑会自动适配 shell 类型（zsh/bash）、写对路径、处理空格和权限，比手动改 ~/.zshrc 更可靠。
- 打开 VSCode，按
⇧⌘P调出命令面板 - 输入
Shell Command: Install 'code' command in PATH，回车执行 - 关闭所有终端窗口，新开一个，运行
code --version验证
如果报 command not found，大概率是终端没重载 shell 配置——不是没装成功，而是新进程没读到 PATH 变更。别重复安装，关掉再开就行。
Windows 上 PATH 配置最容易漏掉的点
很多人在“系统环境变量”里加了 VSCode 的 bin 目录，但依然用不了 code，原因就两个：
- 路径复制错了：必须是包含
code.cmd的那个bin文件夹，比如C:\Users\name\AppData\Local\Programs\Microsoft VS Code\bin，不是Code.exe所在目录 - PATH 没生效：改完环境变量后，已打开的 CMD/PowerShell 不会自动更新 PATH，必须关掉重开
验证方法永远是新开终端，输 where code（CMD）或 Get-Command code（PowerShell），看到路径才真生效。
Linux 用户注意：别直接 alias，要走 PATH
有人喜欢在 ~/.bashrc 或 ~/.zshrc 里写 alias code='.../code'，这会导致两个问题：
- 非交互式 shell 下失效（比如脚本里调用
code会报错） - 某些 IDE 或 GUI 工具启动终端时可能不加载 shell 配置，
code就不可用
正确做法是把 VSCode 的 bin 目录加进 PATH，例如在 ~/.zshrc 末尾加一行：export PATH="/opt/visual-studio-code/bin:$PATH"，然后 source ~/.zshrc。
真正容易被忽略的是：PATH 修改只影响新启动的进程，且不同 shell（zsh/bash/fish）配置文件不同；code 启动后默认不阻塞终端，想等编辑完成再继续执行后续命令，得显式加 --wait 参数。
