VSCode启动失败多数无需重装，应分层排查：先确认进程卡住、白屏、闪退或无反应，再依次尝试--disable-extensions、--disable-gpu或重命名用户数据目录。
VSCode 启动失败，绝大多数情况不用重装，关键在于分层隔离问题来源——先确认是进程卡住、白屏、闪退还是根本没反应，再对应启用 --disable-extensions、--disable-gpu 或重命名用户数据目录。
启动后黑屏/白屏/无窗口？先看有没有残留进程
这种“静默卡死”最常见：双击图标没反应，但任务管理器里能看到 Code.exe（Windows）或 code（macOS/Linux）持续占用 CPU 或内存。这说明 Electron 主进程起来了，但渲染层卡在初始化阶段。
- Windows：打开任务管理器 → “详细信息”页 → 结束所有含
Code、Code Helper、WebView2Runtime的进程 - macOS/Linux：终端运行
ps aux | grep -i code，用kill -9杀掉相关 PID - 杀完立刻试
code --disable-extensions --disable-gpu—— 能出空窗口，就基本排除本体损坏
启动卡在欢迎页、无限加载或报 Failed to fetch？路径里别有中文或空格
VSCode 内部用 URI 解析本地资源，一旦用户目录含中文（如 C:\Users\张三）、空格或特殊符号（如 C:\Users\My Documents），vscode-file:// 协议就会构造失败，导致内置服务器返回 404，控制台刷满 Failed to fetch。
- 临时验证：命令行运行
code --user-data-dir="C:\vscode-test"（确保路径全英文、无空格、不在 OneDrive 同步目录下） - 长期解决：把默认用户数据目录迁到干净路径，例如 Windows 改注册表项
HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders下的Local AppData值 - 别直接复制旧
Cache、GPUCache目录过去——二进制缓存损坏是高频原因
Linux 下启动报 libXss.so.1 缺失？补系统依赖就行
Ubuntu 24.04、Debian 12 或最小化安装的发行版常缺这个库，VSCode 启动时连日志都不输出，直接退出。错误不报在 GUI，而是在终端运行 code --verbose 时看到 libXss.so.1: cannot open shared object file。
- Ubuntu/Debian：运行
sudo apt install libxss1 - CentOS/RHEL：运行
sudo yum install libXScrnSaver（或dnf install libXScrnSaver） - 别试图从源码编译——这个库是标准 X11 扩展，系统包管理器装最稳
code --status 卡在某个扩展？优先怀疑含原生模块的插件
运行 code --status 后输出停在 Activating extension 'ms-python.python' 或类似行，说明扩展初始化阻塞了主线程。这类问题多见于含 node-gyp 编译二进制的插件（Python、Prettier、ESLint、GitLens），尤其在升级 Node.js 或换 Python 版本后。
- 先用
code --disable-extensions验证是否扩展引起 - 再用
code --disable-extensions --verbose看具体哪个扩展 load 失败 - 重点排查最近更新的扩展，以及
ms-python.python、esbenp.prettier-vscode、github.copilot这类依赖运行时环境的插件 - 禁用后不要马上重装——先检查插件文档是否要求特定 Node/Python 版本，再手动删掉
~/.vscode/extensions/xxx文件夹重装
真正难搞的不是报错，而是没报错：进程活着但没窗口、终端能开但欢迎页空白、--verbose 输出戛然而止……这些时候，--user-data-dir 指向新路径是最干净的隔离手段，比猜配置文件哪行错了快得多。
