VSCode启动失败通常因初始化阻塞，应先运行code --verbose定位日志，再检查扩展、用户数据目录、权限及系统依赖；直接重装无效，需逐层排查。
VSCode 启动报错绝大多数不是软件损坏，而是初始化卡在扩展、配置、路径或系统依赖某一层——直接重装没用，得用命令逐层切开看。
code --verbose 能看到卡在哪一行
这是所有排查的起点。GUI 启动失败时，终端里运行 code --verbose 会输出完整初始化日志，关键看最后一行停在哪：
- 卡在
Starting extension host→ 扩展加载阻塞，立刻试code --disable-extensions - 卡在
Unable to read user settings→settings.json语法错误或权限问题，先重命名该文件再启动 - 出现
Failed to fetch大量刷屏 → 用户目录含中文、空格或 OneDrive 同步路径，临时换干净路径验证：code --user-data-dir="C:\vscode-test" - 末尾报
CRASHED或Cannot initialize V8→ 可能缺 Visual C++ 运行库（Windows）或 libXss.so.1（Linux）
code --disable-extensions 是第一道隔离阀
它绕过所有插件逻辑，相当于“裸奔启动”。能进界面，就坐实是扩展问题；不能进，说明问题在更底层（GPU、用户数据目录或系统依赖）。
- Windows 必须先杀光
Code.exe和Code Helper.exe进程，否则可能复用旧状态 - macOS/Linux 建议加
--verbose一起跑：code --disable-extensions --verbose，捕获更早阶段日志 - 禁用后仍闪退？下一步必须试
code --disable-gpu，尤其在远程桌面、Docker 或老旧显卡驱动下，GPU 渲染常静默失败
用户数据目录损坏比你想象中常见
VSCode 把设置、扩展缓存、全局存储全堆在用户数据目录里，一旦被同步工具中断、磁盘写满或权限错配（比如误用 sudo chown），就会静默失败。
- Windows 路径：
%APPDATA%\Code+%USERPROFILE%\.vscode - macOS 路径：
~/Library/Application Support/Code+~/Library/Caches/com.microsoft.VSCode - Linux 路径：
~/.config/Code+~/.vscode - 验证方式：
code --user-data-dir="/tmp/vscode-test"（Linux/macOS）或code --user-data-dir="C:\vscode-test"（Windows），路径必须全英文、无空格、不在 OneDrive 内 - 别直接删原目录，先重命名备份，确认新目录正常后再逐步迁移
settings.json等文本配置
Linux 缺 libXss.so.1 会导致无声退出
Ubuntu 24.04、Debian 12 或最小化安装的发行版常缺这个库，VSCode 启动时连日志都不输出，直接退出。终端运行 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 扩展，系统包管理器装最稳
- 注意：
--user-data-dir对这种缺失无效，必须先装依赖
真正容易被忽略的是：很多“启动失败”其实发生在扩展激活前的配置解析阶段，比如 settings.json 里一个多余的逗号、数字被引号包住、或者路径里用了反斜杠没转义——VSCode 不报错，只卡住。动手前先关进程、重命名配置文件，比反复重装快得多。
