VSCode启动后无窗口大概率是渲染层卡死，先杀残留进程，再运行code --disable-extensions --disable-gpu验证；若弹出空窗口则本体正常，问题在扩展或GPU链路。
VSCode 启动后没窗口，大概率不是软件坏了，而是进程卡在渲染层或根本连不上显示服务——先杀残留进程，再用 code --disable-extensions --disable-gpu 验证是否能出空窗口，能出就说明本体正常。
启动后进程存在但无窗口（黑屏/白屏/任务栏无图标）
这是“静默卡死”的典型表现：主进程起来了，但 Electron 渲染进程无法初始化。常见于 GPU 渲染失败、WebView2 运行时损坏或 DISPLAY 未就绪。
- Windows：打开任务管理器 → “详细信息”页 → 结束所有
Code.exe、Code Helper.exe、WebView2Runtime.exe - macOS/Linux：终端运行
ps aux | grep -i code，用kill -9杀掉所有相关 PID - 杀完立即试
code --disable-extensions --disable-gpu—— 若弹出空窗口，说明问题在扩展或 GPU 链路；若仍无窗口，继续往下查 - Linux 用户务必检查
echo $DISPLAY是否非空，echo $XDG_SESSION_TYPE是否为x11；输出wayland时建议登出后选 “GNOME on Xorg” 再试
启动卡在欢迎页、无限加载或控制台刷 Failed to fetch
这不是网络问题，是 VSCode 内部 URI 构造失败导致内置服务器返回 404。根本原因常是用户目录含中文、空格或同步盘路径（如 OneDrive），vscode-file:// 协议解析崩溃。
- 临时验证：运行
code --user-data-dir="C:\vscode-test"（Windows）或code --user-data-dir="/tmp/vscode-test"（macOS/Linux），路径必须全英文、无空格、不在同步目录内 - 长期解决：迁移到干净路径，例如 Windows 改注册表项
HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders下的Local AppData值 - 别直接删原
%APPDATA%\Code或~/.vscode，先重命名备份（如Code-backup），确认新目录可用后再逐步迁移settings.json
启动报错 ERR! spawn ENOENT 或 permission denied
这类错误指向外部进程调用失败，常见于扩展试图启动 Python、clangd、Prettier 等二进制，但路径配置错误、文件不存在或权限不足。
- 检查
settings.json中类似python.defaultInterpreterPath、prettier.path、eslint.runtime的配置项，确认路径真实存在且可执行 - Linux 报
libXss.so.1: cannot open shared object file？立刻装依赖：sudo apt install libxss1（Ubuntu/Debian）或sudo dnf install libXScrnSaver（Fedora） - Windows 上若日志反复出现
MSVCP140.dll错误，说明 Visual C++ 运行库缺失，需安装 KB2999226（Win7）或对应新版运行库 - 插件缓存写入 OneDrive/Downloads 目录也会触发
EACCES，查看插件文档是否支持自定义缓存路径（如"claude.cachePath"），设为%USERPROFILE%\AppData\Local\ClaudeCache
settings.json 语法错误导致静默拒载
VSCode 启动时会先解析 settings.json，一个多余逗号、引号不闭合、数字加引号（如 "editor.fontSize": "14"），都会让它直接退出——不报错、不弹窗、只留一个空进程。
- 路径位置：
%APPDATA%\Code\User\settings.json（Windows）、~/Library/Application Support/Code/User/settings.json（macOS）、~/.config/Code/User/settings.json（Linux） - 最稳妥做法：关所有 VS Code 进程 → 重命名
settings.json为settings.json.bak→ 启动 VSCode；若恢复，说明原文件有误 - 别用记事本改 JSON，用 VSCode 自带命令
Preferences: Open Settings (JSON)（Ctrl+Shift+P），它带实时校验和高亮 - 常见雷区：
"files.associations": { "*.py": "python", }（末尾逗号非法）、"workbench.startupEditor": "none"（值应为字符串，但部分字段要布尔值）
真正容易被忽略的是：很多“启动失败”其实发生在进程已启动但尚未渲染出第一个像素的阶段——这时候看任务管理器比等 GUI 更快，--log trace 输出的最后三行，往往藏着 CRASHED 或 Cannot initialize V8 这类关键线索。
