VSCode启动失败90%不用重装，应按顺序验证：先code --disable-extensions --disable-gpu确认是否为GPU/扩展问题；再用code --user-data-dir测试用户目录是否损坏；最后查code --status定位具体扩展或日志异常。
VSCode 启动失败，90% 不用重装——关键在分层验证顺序，先绕过扩展和 GPU 渲染，再查用户数据目录是否损坏。
code --disable-extensions 启动成功但 GUI 卡白屏？优先加 --disable-gpu
很多用户发现禁用扩展后能进空窗口，但一启用就黑屏/白屏，这基本锁定是 Electron 渲染层与显卡驱动不兼容。尤其常见于：远程桌面、WSL2 GUI、老旧 Intel HD Graphics、或某些国产精简版系统。
- 直接运行
code --disable-extensions --disable-gpu，能稳定进入界面 → 说明问题出在 GPU 加速链，不是扩展本身 - Windows 快捷方式右键 → 属性 → “目标”末尾追加
--disable-gpu（注意前加空格），可长期规避（不推荐永久使用，但排查期安全） - Linux 下若报
Failed to move to new namespace，必须搭配--no-sandbox，即：code --disable-gpu --no-sandbox - macOS M 系列芯片用户若启动极慢，可试
code --disable-gpu --force-renderer-accessibility，绕过 Metal 渲染初始化阻塞
code --status 卡在 “Activating extension”？用 --disable-extension 精准屏蔽
code --status 输出末尾如果停在某扩展名后长时间无响应，或出现 ERR! spawn ENOENT、Extension host terminated unexpectedly，就是它了。别猜，直接禁用。
- 先查所有已安装扩展：
code --list-extensions - 禁用单个扩展（例如最近更新的 Python 插件）：
code --disable-extension ms-python.python - 若不确定是谁，用二分法：先禁用一半（如前 5 个），能启则问题在另一半；再细分，比逐个试快得多
- 注意：有些插件（如旧版
vscode-icons）会修改argv.json，即使禁用也残留影响，需手动删掉对应目录：~/.vscode/extensions/ms-python.python-2026.x.x
启动闪退 + 任务管理器里 code.exe 频繁启停？检查用户数据目录是否损坏
VSCode 启动时会读取 User Data 目录下的 Cache、GPUCache、workspaceStorage 等子目录。其中任一损坏，都可能触发无限崩溃循环——表现为刚点开就退出，进程反复创建销毁。
- 临时跳过原目录启动：
code --user-data-dir="/tmp/vscode-clean"（Linux/macOS）或code --user-data-dir="D:\vscode-test"（Windows） - 若能正常打开，说明原目录损坏。不要直接删整个目录，先备份，再重命名原路径（如
Code-backup），让 VSCode 自建干净目录 - 迁移时只拷贝文本类配置：
settings.json、keybindings.json、snippets/；绝对避开Cache/、GPUCache/、Crashpad/这些二进制缓存目录 - Windows 用户注意：
%APPDATA%\Code和%USERPROFILE%\AppData\Roaming\Code是同一位置，别重复操作
GNOME / KDE 桌面下通过图标启动失败，终端却正常？环境变量未继承
Ubuntu GNOME 或某些 KDE 环境中，桌面启动器不会自动继承 shell 的 HTTP_PROXY、NOFILE 等环境变量，导致依赖代理的插件（如 Codex、GitHub Copilot）卡在加载状态，日志里反复出现远程请求超时或 connect ECONNREFUSED 127.0.0.1:7897。
- 不要改系统级
/etc/environment或全局 shell 配置，风险高且不必要 - 创建包装脚本（如
~/bin/code-env），内容包含export HTTP_PROXY="http://127.0.0.1:7897/"和ulimit -Sn 65536，最后用exec /usr/bin/code "$@" - 给脚本加执行权限：
chmod +x ~/bin/code-env - 把桌面收藏夹指向该脚本，而非直接调用
code - 验证是否生效：启动后按
Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools→ 控制台里执行process.env.HTTP_PROXY，应返回你设的地址
最常被忽略的是：用户数据目录损坏后，--disable-extensions 和 --disable-gpu 都可能失效——因为扩展状态、窗口布局、甚至语言包缓存都存在里面。所以排查时，--user-data-dir 必须作为独立验证项穿插在中间，不能只放在最后。
