VSCode 的 code 命令默认未注册到 PATH，需通过命令面板执行“Shell Command: Install 'code' command in PATH”手动安装；该命令灰显通常因使用非官方安装包、首次初始化未完成或 macOS 权限拦截所致。
VSCode 的 code 命令默认不生效，必须手动注册到系统 PATH；不是环境变量没配好，是根本没安装这个命令。
Shell Command: Install 'code' command in PATH 为什么点不了？
该命令灰显或不可用，通常有三个原因：
- 你用的是非官方安装包：比如从 .zip 解压运行、Snap/Flatpak 安装版、或某些 Linux 发行版仓库里的阉割版——它们没提供
code包装脚本，菜单项自然不可用 - VS Code 还没完成首次初始化：刚解压启动、没加载过用户数据目录（
~/.vscode或%APPDATA%\Code），部分功能暂未就绪 - 权限问题（macOS 尤其常见）：App 被系统拦截，无法写入
/usr/local/bin；此时需在终端中手动创建符号链接，或改用sudo授权（不推荐长期使用）
Windows 上 code 命令报 “not recognized” 怎么办？
即使勾选了安装时的 “Add to PATH”，PowerShell/CMD 仍可能找不到命令，因为：
- PATH 只对新启动的终端生效：旧窗口不会自动重载环境变量，必须关闭再开
- 安装路径可能被写错：官方安装默认路径是
C:\Users\{user}\AppData\Local\Programs\Microsoft VS Code\bin，但若你选了“所有用户”安装，实际路径可能是C:\Program Files\Microsoft VS Code\bin - PowerShell 执行策略阻止脚本：如果
code是个 PowerShell 脚本（某些企业镜像版会这样），会触发execution of scripts is disabled错误，临时修复用：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
macOS/Linux 下 code 启动后路径打不开？
code ~/project 失败不是 bug，是设计如此：VS Code 不做 shell 展开，~ 被当字面字符串处理。正确做法只有两个：
- 先
cd进目标目录，再执行code .（最稳，无歧义） - 用绝对路径：如
code /Users/you/project或code /home/you/project - 路径含空格或中文？必须加双引号：
code "./my project"，否则 shell 分词失败，VS Code 收到的是破碎路径
code 命令阻塞等待编辑器关闭，为什么有时不生效？
code --wait . 只在首次启动 VS Code 实例时阻塞；如果后台已有 Code Helper 进程在运行，它会立刻返回，根本不管当前窗口是否关闭。这在脚本中尤其危险——比如你写了个构建后自动打开日志文件的流程，--wait 失效会导致后续命令提前执行。
真正可靠的替代方案是：code --new-window --wait .（强制新建窗口 + 阻塞），或改用进程监控方式（如检查 pgrep -f "Code.*--status"）。
容易被忽略的一点：cron、systemd 或 CI 环境里调用 code，几乎必然失败——这些场景没有 GUI session，code 会静默退出。此时应改用 code --list-extensions 这类无界面命令，或彻底放弃依赖图形编辑器的自动化逻辑。
