code命令是否已加入PATH的验证第一步是运行code --version或which/where code，若报command not found则说明未注册PATH，需通过VSCode命令面板执行“Shell Command: Install 'code' command in PATH”并新开终端验证。
code 命令是否已加入 PATH
验证的第一步不是启动 VSCode，而是确认系统能否识别 code 这个命令。在任意终端（非 VSCode 内置终端）中运行：
-
code --version—— 应输出类似1.89.0的版本号 -
which code（macOS/Linux）或where code（Windows）—— 应返回一个真实可执行文件路径，如/usr/local/bin/code或C:\Users\Alice\AppData\Local\Programs\Microsoft VS Code\bin\code
如果报 command not found 或 'code' is not recognized，说明安装时没勾选「添加到 PATH」，或安装包未完成注册（常见于 Windows 用户双击安装但跳过关键选项）。此时重装并务必勾选该选项，不要依赖“重启电脑”——只要 VSCode 是从开始菜单或 Dock 启动的，PATH 就不会更新。
code . 是否能正确触发守护进程
code 命令默认以守护模式（daemon mode）运行：它 fork 出主进程后立即退出 shell，不阻塞终端。所以光标立刻返回 ≠ 启动成功。
- 运行
code . && sleep 1 && pgrep -f 'Code Helper|Electron' >/dev/null && echo "ok"（Linux/macOS） - 或 Windows 上：
code . & timeout /t 1 >nul & tasklist /fi "imagename eq Code.exe" 2>nul | findstr /i "Code.exe" >nul && echo ok - 若无输出，说明进程未存活；若输出
ok，再检查ps aux | grep -v grep | grep -i 'code.*--no-sandbox'是否有非僵尸态进程
注意：禁用 GPU 或沙箱（code --disable-gpu --no-sandbox）后能启动，但默认参数下失败，大概率是显卡驱动、SELinux/AppArmor 或杀毒软件拦截了渲染进程。
renderer.log 是否生成
renderer.log 是最底层的成功信号——它只在 Electron 渲染器进程真正初始化并准备绘制窗口时才被创建。缺失该文件，说明卡在比扩展加载更早的阶段。
- 先用
code --log trace启动，观察终端最后几行是否出现workbench.main.js loaded或Starting extension host - 若卡在
app.onReady之前，且日志目录（通常为~/.config/Code/logs/或%APPDATA%\Code\logs\）里没有renderer.log，基本可排除配置问题，直奔系统级限制排查 - 重点检查：
sharedprocess.log是否报Failed to create shared process（IPC 失败、/tmp不可写、磁盘满）、gpu-process.log是否为空或含segmentation fault
右键菜单和桌面快捷方式是否可用
安装时勾选的「添加到右键菜单」「创建桌面快捷方式」等选项，本质是向系统注册协议处理和 shell 扩展。它们不依赖 code 命令本身，但能交叉验证安装完整性。
- 在任意文件夹空白处右键，应出现「Open with Code」或「Open with Code (Explorer)」选项
- 点击桌面快捷方式，应直接启动 VSCode（而非报错“找不到目标”或弹出安装向导）
- 若这些功能正常，但
code --version失败，说明 PATH 未设，但注册表/launchd 配置已生效 —— 此时只需补全环境变量，无需重装
最容易被忽略的是：Windows 上「添加到 PATH」选项仅对新启动的进程生效，已打开的 CMD/PowerShell 和 VSCode 都不会自动刷新；macOS/Linux 上 GUI 启动的 VSCode 不读 ~/.zshrc，必须用终端执行 code . 启动才能继承正确 PATH。
