VSCode启动失败应优先用命令行诊断：先运行code --status定位扩展卡死，再用code --disable-extensions验证是否扩展导致；若仍失败，依次尝试code --disable-gpu、code --user-data-dir指定干净目录、code --log trace分析底层崩溃点。
VSCode 启动失败时，命令行是最快、最直接的诊断入口——GUI 不出来，但终端永远能说话。
code --status 能快速定位扩展卡死
这个命令不启动图形界面，只输出当前 VSCode 的进程状态和扩展加载日志。它能立刻告诉你是不是某个扩展拖垮了整个启动流程。
- 如果输出末尾卡在
Activating extension ms-python.python或类似行，说明该扩展初始化超时或崩溃 - 出现
ERR! spawn ENOENT表示某个扩展试图启动外部进程（如 Python 解释器、clangd），但路径配置错误或文件不存在 - 若看到大量
Failed to load resource，优先检查用户数据目录是否损坏（见下一条）
code --disable-extensions 是验证问题根源的第一步
它绕过所有扩展加载逻辑，相当于“裸奔启动”。能启动，就坐实问题是扩展导致；不能启动，则要往系统依赖或 GPU 层面查。
- Windows 用户注意：必须关闭所有
Code.exe和Code Helper.exe进程后再运行，否则可能复用旧进程状态 - macOS/Linux 下建议加
--verbose：例如code --disable-extensions --verbose，可捕获更早阶段的日志 - 如果禁用扩展后仍闪退，下一步应试
code --disable-gpu—— 尤其在远程桌面、Docker 或老旧显卡驱动环境下，GPU 渲染常静默失败
code --user-data-dir 指定干净配置目录
用户数据目录（%APPDATA%\Code 或 ~/.vscode）一旦损坏，会导致设置不生效、终端打不开、甚至欢迎页无限加载。用新目录启动，是最轻量的“重置”方式。
- 推荐路径：全英文、无空格、不在 OneDrive/同步盘内，例如
code --user-data-dir="C:\vscode-clean" - 不要直接删除原目录，先重命名备份（如
Code-backup），确认新目录正常后再逐步迁移settings.json等文本配置 - Linux 用户若报
libXss.so.1: cannot open shared object file，说明系统缺依赖，此时--user-data-dir无效，得先装libxss1
code --log trace 输出底层崩溃点
这是最后也是最硬的排查手段。它会把 Electron 初始化、窗口创建、IPC 连接等环节的每一步都打出来，适合定位“无声卡死”类问题。
- 运行
code --log trace --status，观察最后几行是否出现CRASHED、Failed to create window、Cannot initialize V8 - Windows 上若日志里反复出现
MSVCP140.dll相关错误，说明 Visual C++ 运行库缺失，需安装 KB2999226（Win7）或 VC++ 2015–2022 Redistributable - macOS 若提示
WebView2Runtime.exe not found，说明 VSCode 1.80+ 依赖的 WebView2 运行时损坏，需单独重装 Microsoft Edge WebView2 Runtime
命令本身不解决根本问题，但能精准告诉你问题在哪一层——是扩展、配置、GPU、系统依赖，还是某条路径里藏着一个中文字符或空格。真正容易被忽略的，往往是那些没报错却卡住的环节：比如用户数据目录权限异常、WebView2 运行时静默失效、或者 launch.json 里一个反斜杠没转义。这些地方，GUI 不说话，但命令会。
