code命令是否已正确注册到path，需通过where code（windows）或which code（macos/linux）验证；无输出即未注册，应使用vscode命令面板执行“shell command: install 'code' command in path”修复并重启终端。
code 命令是否已正确注册到系统 PATH
VSCode 的命令行启动能力依赖 code 可执行文件是否被加入系统环境变量 PATH。没加进去，终端输 code 就会报 command not found 或 'code' is not recognized as an internal or external command。
实操建议：
- Windows：打开 PowerShell，运行
where code；若无输出，说明未注册。去 VSCode 安装目录（如C:\Users\<username>\AppData\Local\Programs\Microsoft VS Code\bin</username>）确认是否存在code.cmd，再右键 VSCode 快捷方式 → 属性 → “高级” → 勾选“以管理员身份运行此程序”后重试一次“Shell Command: Install 'code' command in PATH” - macOS/Linux：终端执行
which code，若为空，检查是否在 VSCode 设置里开启了Shell Command: Install 'code' command in PATH（需重启终端生效）；也可手动软链：sudo ln -s /Applications/Visual Studio Code.app/Contents/Resources/app/bin/code /usr/local/bin/code - 验证是否生效：新开一个终端窗口，直接输入
code --version，应立即返回类似1.85.1的版本号，不卡、不报错、不弹 GUI 窗口
code 启动时是否被杀毒软件或安全策略拦截
尤其在企业设备或国产系统上，code.exe（Windows）或 code 二进制（macOS/Linux）可能被误标为“可疑程序”，导致进程被静默终止——表现为终端敲了 code 没反应、无报错、也无窗口，ps aux | grep code 或任务管理器里完全找不到进程。
实操建议：
- Windows：先关掉 Windows Defender 实时保护，或临时将
code.exe路径（如C:\Users\<username>\AppData\Local\Programs\Microsoft VS Code\Code.exe</username>）添加到排除项；再试code --disable-extensions --verbose，看终端是否输出日志 - macOS：检查“系统设置 → 隐私与安全性 → 完全磁盘访问”中是否允许
Visual Studio Code；若刚从官网下载，首次运行可能被 Gatekeeper 阻止，需右键应用 → “打开”绕过 - Linux：某些 SELinux 或 AppArmor 策略会阻止 Electron 应用拉起渲染进程，可临时用
setenforce 0（仅测试）验证；或改用code --no-sandbox --disable-gpu绕过沙箱初始化
code --status 是否能快速返回扩展状态
code --status 是最轻量的“健康检查”命令：它不打开 UI，只连接已运行的 VSCode 实例（或启动一个最小化后台进程），输出当前扩展激活状态、主进程 PID、GPU 信息等。如果这个命令卡住、超时、或报 ERR! spawn ENOENT，说明底层 IPC 或主进程通信已异常。
实操建议：
- 先确保没有其他 VSCode 进程在运行（包括隐藏的
Code Helper），用killall -9 code（macOS/Linux）或任务管理器结束全部code.exe相关进程 - 运行
code --status，正常应在 2 秒内返回文本；若卡超过 10 秒，立刻 Ctrl+C 中断，改试code --disable-extensions --status - 若禁用扩展后
--status正常，说明某个扩展的activate()函数阻塞了主进程——重点查GitLens、ms-python.python、esbenp.prettier-vscode这类含原生模块或文件监听逻辑的扩展
code --verbose 输出末尾是否出现致命错误
code --verbose 强制打印从 Electron 初始化到窗口创建的全过程日志，是定位“无声失败”的唯一可靠手段。很多问题（如 GPU 初始化失败、用户数据目录权限错误、XDG_RUNTIME_DIR 未设置）不会弹窗，但会在日志末尾暴露真实原因。
实操建议：
- Windows：用 PowerShell 运行
code --verbose，别用 Git Bash（GUI 启动兼容性差）；留意最后一行是否含libEGL initialization failed、Failed to load module "appmenu-gtk3"或Unable to read file '/.../Cache/' (Error: EACCES) - Linux：确保
$XDG_RUNTIME_DIR已设置且可写，运行echo $XDG_RUNTIME_DIR && ls -ld $XDG_RUNTIME_DIR；若为空或权限不对，先执行export XDG_RUNTIME_DIR=/tmp/runtime-$USER再试code --verbose - macOS：若看到
Failed to create CoreImage context，大概率是 macOS 版本低于 12.0，或 M 系列芯片上运行了旧版 VSCode（需 ≥1.75）；此时加--disable-gpu --force-renderer-accessibility可绕过 Metal 初始化阻塞
code --status 卡住，大概率不是 code 命令坏了，而是已有 VSCode 主进程僵死却没释放 socket 文件，新进程连不上。这类细节不看 --verbose 日志根本发现不了。
