VS Code 的 code 命令在 macOS 终端不可用，根本原因是未通过官方图形界面执行“Shell Command: Install 'code' command in PATH”注册到 PATH，而非环境变量配置错误；需在 VS Code 中用 Cmd+Shift+P 调出命令面板运行该操作，重启终端后 code --version 才有输出。
code 命令在 macOS 终端里用不了，不是 VS Code 没装好，而是它根本没注册进系统 PATH —— 90% 的人卡在这一步，而不是后续操作。
为什么终端输 code --version 没反应
这不是环境变量配置错，是压根没注册。VS Code 官方安装包自带一个 shell 包装器：/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code，但它默认不加入 PATH。你直接运行这个路径能启动，但终端不认识 code 这个命令。
- 执行
code --version报command not found→ 立刻停手，别试code .，那只会静默失败 - iTerm2 / zsh 用户特别容易忽略：改完 PATH 后必须关掉所有终端窗口再重开，旧会话不会自动 reload
- .zip 解压版、Snap 或第三方打包版（如某些 Homebrew Cask 非官方源）不提供
Shell Command: Install 'code' command in PATH选项，会灰显不可用——得换回官网下载的 .dmg 安装包
正确注册 code 命令的唯一可靠方式
打开 VS Code 图形界面，用命令面板触发注册，这是苹果生态下最稳定的做法。
- 快捷键
Cmd + Shift + P调出命令面板 - 输入
Shell Command: Install 'code' command in PATH，回车执行 - 关闭当前终端，新开一个，再运行
code --version—— 有输出就成功了 - 该操作只对当前用户生效，且依赖 VS Code 自带的包装脚本，不是简单加软链或改 PATH 变量
code . 打不开当前目录？检查这三件事
注册成功后，code . 行为受已有实例和参数影响，不是“一输就开”那么简单。
- 路径含空格或中文？必须用双引号：
code "my project"，否则被 shell 拆成多个参数，VS Code 报Unable to resolve non-existing file - 想复用当前窗口（避免弹新窗口）？加
-r：code -r . - 想强制新开独立窗口（比如对比两个项目）？用
-n：code -n . - WSL 或远程 SSH 场景下
code .必然失败——那是 Linux 子系统，code是 macOS 主机上的命令，得用 Remote - SSH 扩展配合code命令在远端触发
手动加 alias 是备选，但有隐藏代价
如果命令面板注册失败（比如用了非官方版本），可以临时用 alias，但要注意它的局限性。
- 往
~/.zshrc里加：alias code='/Applications/Visual\ Studio\ Code.app/Contents/Resources/app/bin/code' - alias 只在当前 shell 类型生效（zsh 用户写 ~/.zshrc，bash 用户写 ~/.bash_profile），且不传递给子进程（比如脚本里调用可能失效）
- 不能支持
-g跳转参数的完整解析（部分 shell 对冒号敏感，需额外引号包裹） - 每次 VS Code 升级后，如果内部路径变更（极少见但存在），alias 会失效，而官方注册方式会自动适配
真正麻烦的从来不是 code . 这一行命令，而是 PATH 注册是否彻底、终端会话是否刷新、以及你用的是不是那个能自动生成包装器的官方安装包——这三个点漏掉任何一个，后面所有参数都白搭。
