VS Code 的 code 命令需通过图形界面执行“Shell Command: Install 'code' command in PATH”注册，且必须新开终端生效；code --wait 仅适用于有 GUI 的交互式会话。
code 命令根本找不到？先确认是否注册进 PATH
终端输入 code --version 报 command not found: code，不是环境变量配错，而是 VS Code 根本没把 CLI 工具注册进系统。这个动作必须通过图形界面触发，无法纯命令行完成。
- 打开已运行的 VS Code（不能是崩溃或未完全加载状态）
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Shell Command: Install 'code' command in PATH并回车执行 - 关闭所有已有终端窗口，**新开一个终端**再试
code --version - 失败常见原因：用的是 .zip 解压版、Snap/Flatpak 包、或企业策略禁用了包装器——换官方安装包最省事
Windows 上 code . 一闪而过或打不开文件夹？检查路径和权限
命令能执行但窗口不持久、资源管理器空白，大概率是路径解析或会话上下文问题，不是 code 本身坏了。
- 确保当前终端有读取目标目录的权限；若在 PowerShell 中以管理员身份运行，而目标路径在用户目录下，可能因 UAC 隔离导致工作区加载失败
- 路径含空格无需引号，但含中文或特殊字符时，建议用正斜杠写法：
code C:/Users/张三/project比code C:\Users\张三\project更稳 - 末尾带斜杠的路径如
code ./my-project/可能被某些版本误判为“非文件夹”，去掉结尾/再试 - 左下角显示
No folder opened？说明只是启动了编辑器，没加载工作区——关掉窗口，用code C:\full\path\to\project显式指定绝对路径重试
macOS / Linux 下 code 启动失败？别硬改 PATH，优先走内置注册
手动往 ~/.zshrc 或 ~/.bashrc 里加 alias 或 PATH 是可行的临时方案，但会绕过 VS Code 自带的包装器逻辑，导致 --wait、--reuse-window 等参数失效，甚至无法正确传递 GUI 环境变量。
- 首选仍是图形界面中执行
Shell Command: Install 'code' command in PATH—— 它会在/usr/local/bin/code创建符号链接，指向 App 内部真实二进制：/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code - 如果
/usr/local/bin不在你的$PATH中（比如某些 zsh 配置默认不包含），就补上：export PATH="/usr/local/bin:$PATH"到 shell 配置文件 - 验证是否生效：运行
which code应输出/usr/local/bin/code，而非你手动写的 alias 路径
脚本里调用 code --wait 却卡住？注意 GUI 环境和阻塞语义
code --wait 的设计是让终端挂起，直到 VS Code 窗口关闭才返回控制权。但它依赖完整的桌面会话环境，在无 GUI 场景（如 cron、systemd service、SSH 无 X11 转发）下会直接失败或无限等待。
- CI/自动化脚本中不要用
--wait，改用code --list-extensions这类无界面命令做健康检查 - 需要等编辑完成再继续的场景（如提交前修改 commit message），确保脚本运行在有 DISPLAY 或 Wayland 环境的交互式终端中
- Linux 上若提示
Cannot open display，说明缺少 X11 转发，此时code无法弹窗，--wait必然卡死 - macOS 使用 AppleScript 替代方案更可靠：
osascript -e 'tell app "Visual Studio Code" to activate'，但不支持 --wait 语义
