必须先在 vs code 图形界面中执行“shell command: install 'code' command in path”注册，否则 code 命令根本未安装到系统，终端输入 code --version 必报 command not found；该操作仅对当前用户生效，且仅官方 .deb/.rpm/.pkg 安装包支持，.zip/snap 等版本无此功能。
必须先在 VS Code 图形界面中手动注册 code 命令，否则终端里输 code --version 一定会报 command not found——这不是环境变量配置错误，而是命令压根没装进系统。
为什么 code 命令默认不可用
VS Code 安装包自带一个 shell 包装器（macOS 在 /Applications/Visual Studio Code.app/Contents/Resources/app/bin/code，Windows 在 C:Users{user}AppDataLocalProgramsMicrosoft VS Codeincode.cmd），但它不会自动加到 $PATH 或系统环境变量里。哪怕你重装过、换过用户、甚至重启了电脑，只要没手动触发注册，code 就不存在。
常见误判点：
- 以为是 PATH 没配对——其实根本没东西可找
- 在 .zip 解压版或 Snap/Flatpak 版本里找
Shell Command: Install 'code' command in PATH，结果菜单灰显——这些版本不带包装器，该命令无效 - 执行完命令后没关掉旧终端，直接在原窗口试
code --version——PATH 变更不会热加载
正确启用步骤（跨平台通用）
打开已运行的 VS Code 图形界面，按快捷键调出命令面板：
- macOS：按
Cmd+Shift+P - Windows/Linux：按
Ctrl+Shift+P
输入并选择：Shell Command: Install 'code' command in PATH，回车执行。
然后：
- 关闭所有已打开的终端（CMD、PowerShell、iTerm、Terminal 等）
- 新开一个终端窗口
- 运行
code --version验证是否输出版本号
若失败，检查安装来源：非官方安装包（如 GitHub Releases 下载的 .zip、Linux 上的 Snap）大概率不支持此功能，需改用官网提供的 .deb/.rpm/.pkg 安装包。
Windows 特别注意事项
即使图形界面注册成功，PowerShell 或 CMD 仍可能报错，原因通常是：
- 安装时未勾选
Add to PATH（企业部署或静默安装常跳过） - 用户权限不足，导致注册脚本写入
%USERPROFILE%AppDataLocalin失败 - 路径含空格或中文时未用引号包裹，例如
code C:my project应写成code "C:my project"
手动补救方式（仅当注册命令不可用时）：
- 把
C:Users{user}AppDataLocalProgramsMicrosoft VS Codein加入系统环境变量PATH - 重启资源管理器或整个系统，确保新 PATH 生效
code 启动后打不开文件夹？先看状态栏
命令执行无报错，但 VS Code 弹出空白窗口、左下角显示 No folder opened，说明路径没被识别为工作区目录。这不是启动失败，而是路径解析问题：
- 避免末尾斜杠：
code /path/to/project/改为code /path/to/project - 不要用波浪线：
code ~/project会被字面解析，应先cd ~/project && code .或用绝对路径 - UNC 路径（如
\servershare）和符号链接在某些 VS Code 版本中支持不稳定，优先映射为本地盘符或用正斜杠路径
最稳的做法永远是：先 cd 进目标目录，再执行 code .——它不依赖路径拼写容错，也不受 shell 解析干扰。
