code命令失效的根本原因是未成功注册到PATH：必须通过VS Code图形界面执行“Shell Command: Install 'code' command in PATH”，再彻底退出VS Code并重启终端验证；非官方安装包（如Snap、.zip解压版）不支持该功能。
code 命令在终端里显示“找不到命令”，不是 VSCode 没装好，而是它根本没注册进系统 PATH —— 你得手动触发注册，或补全路径，不能只靠安装时勾选。
VSCode 自带的 Shell Command 注册必须图形界面触发
很多人点过一次 Shell Command: Install 'code' command in PATH 就以为完事了，但实际它只对当前用户、当前 Shell 类型生效，且依赖 VS Code 官方安装包里的 bin 包装器。非官方安装方式（比如 .zip 解压版、Snap 包、Mac 上仅拖拽 .app 未运行 installer）压根不支持该命令。
- 必须先用图形界面打开 VS Code（双击图标或从 Dock 启动），再按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）调出命令面板 - 搜索并执行
Shell Command: Install 'code' command in PATH，看到成功提示后，**不是关掉终端标签页，而是彻底退出 VS Code 进程**（Windows 任务栏右键 → “退出”，macOS Dock 右键 → “退出”） - 重新打开终端，运行
code --version验证；若仍失败，说明你用的是不支持该功能的安装包（如 Linux Snap 版），需换 deb 或手动软链
Windows 手动加 PATH 要确认 bin 目录存在
VS Code 的 code 命令实际是 code.cmd，位于安装目录下的 bin 子目录。很多用户只加了主目录（如 C:\Users\XXX\AppData\Local\Programs\Microsoft VS Code），漏掉了 \bin。
- 先在系统 CMD 中运行
where code，看是否返回类似C:\Users\XXX\AppData\Local\Programs\Microsoft VS Code\bin\code.cmd的路径 - 如果返回空，说明
bin目录没被加入 PATH；打开「系统属性 → 高级 → 环境变量」，在「系统变量」中编辑Path，新增一行：C:\Users\XXX\AppData\Local\Programs\Microsoft VS Code\bin（注意路径以你实际安装位置为准，反斜杠不用双写） - 改完后，**必须新开一个 CMD 或 PowerShell 窗口验证**，旧终端进程不会自动刷新 PATH
macOS / Linux 要检查 /usr/local/bin/code 是否存在且可执行
macOS 官方安装包会在安装时自动创建 /usr/local/bin/code 符号链接，指向 app 内部的二进制。如果这个链接损坏或缺失，code 命令就不可用。
- 终端中运行
ls -l /usr/local/bin/code，应看到类似code -> /Applications/Visual Studio Code.app/Contents/Resources/app/bin/code的输出 - 如果报 “No such file”，说明链接丢失；可手动重建：
sudo ln -sf "/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code" /usr/local/bin/code - Linux（如 Ubuntu）若用 Snap 安装，
code默认不可用，因 Snap 沙箱限制；推荐改用.deb包，或手动软链：sudo ln -sf /snap/code/current/usr/share/code/bin/code /usr/local/bin/code
PATH 加对了但 code . 一闪而过？重点查路径和权限
命令能识别但执行失败，往往不是环境变量问题，而是启动上下文异常。
- 当前路径含空格或中文时，必须用双引号包裹：
code ".\my project"或code "D:\我的项目" - PowerShell 中执行失败，先运行
Get-ExecutionPolicy -Scope CurrentUser，若返回Restricted，需在**管理员权限的 PowerShell** 中执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 某些企业策略或杀毒软件（如 Windows Defender 实时保护）会拦截 VS Code 启动子进程；临时禁用后测试，若恢复则需白名单添加
code.exe
最常被跳过的动作是：改完 PATH 或执行策略后，没彻底退出 VS Code 进程就重开终端——GUI 应用只读取一次环境快照，不退出等于没改。
