VSCode启动卡顿或闪退主因是扩展激活失败、settings.json语法错误、用户数据目录损坏或环境变量污染；应依次通过禁用扩展、校验配置、清理缓存、清空环境变量排查。
VSCode 启动卡在“正在加载扩展”或直接闪退
大概率是某个扩展的激活逻辑崩溃，或扩展缓存损坏。VSCode 启动时会同步加载所有启用的扩展，一旦某个扩展的 package.json 描述异常、入口文件（activationEvents）触发失败，或其依赖的本地模块加载出错，就可能阻塞主进程。
实操建议：
- 用命令行启动并查看错误：在终端执行
code --disable-extensions --log trace，观察输出中是否出现Activating extension...后长时间无响应或报Cannot find module - 临时禁用全部扩展：启动时加参数
--disable-extensions，确认能否正常进入界面；能则说明问题出在扩展层 - 定位问题扩展：逐个启用扩展（通过
Ctrl+Shift+P→Extensions: Enable Extension），配合重启验证；重点关注近期更新过、使用原生模块（如node-gyp编译）、或依赖特定 Node.js 版本的扩展（如esbuild相关、prettier自定义插件）
用户设置（settings.json）语法错误导致配置加载失败
VSCode 读取 settings.json 是同步阻塞行为。一个多余的逗号、未闭合的引号、或非法的 JSON5 特性（如注释写在对象末尾逗号后），都可能导致整个配置解析失败，进而让窗口白屏或回退到默认设置界面。
实操建议：
- 用 VSCode 自带的 JSON 校验：打开
settings.json（Ctrl+, → 点右上角花括号图标），编辑器底部状态栏若显示JSON Error，鼠标悬停即可看到具体位置和原因 - 手动检查高频出错点：
"files.exclude": { "**/.git": true, }尾部多余逗号、"editor.fontSize": 14,在根对象末尾多加逗号、用单引号代替双引号、在注释后直接跟逗号 - 安全重置法：把当前
settings.json重命名为settings.json.bak，再重启 VSCode —— 它会生成一份干净的默认配置，之后可逐段粘贴旧配置验证
用户数据目录（User Data Dir）损坏引发持续崩溃
VSCode 的用户数据目录（含扩展安装、全局设置、窗口状态、搜索历史等）一旦因强制关机、磁盘写入中断或权限异常损坏，会导致反复启动失败，即使禁用扩展也无效。常见现象包括：启动后立即弹出「We've detected that your system is low on memory」警告（实际内存充足）、控制台报 ENOENT: no such file or directory, open '.../User/workspaceStorage/xxx/...'、或日志里反复出现 Failed to load window state。
实操建议：
- 确认当前用户数据路径：
code --help查看--user-data-dir默认值；Windows 通常为%APPDATA%\Code\User，macOS 为~/Library/Application Support/Code/User，Linux 为~/.config/Code/User - 不要直接删整个
User文件夹 —— 会丢失所有自定义设置；优先尝试只清空子目录：workspaceStorage（缓存工作区元数据）、globalStorage（扩展私有存储）、History（搜索/替换历史） - 若仍无效，可备份
settings.json和keybindings.json后，彻底删除整个User目录，再重启 VSCode —— 它会重建目录结构，你只需重新导入那两个文件
Shell 环境变量污染导致 Electron 主进程初始化失败
VSCode 基于 Electron，启动时会继承系统 Shell 的环境变量。某些被注入的变量（如 LD_PRELOAD、__PYVENV_LAUNCHER__、或自定义的 NODE_OPTIONS）可能干扰 Chromium 渲染进程或 Node.js 运行时，表现为黑屏、白屏、或控制台报 Failed to get the number of displays / Segmentation fault (core dumped)。
实操建议：
- 对比干净环境：在终端运行
env -i code --disable-extensions（env -i清空所有环境变量），若此时能启动，说明问题出在环境变量 - 排查可疑变量：重点检查
echo $NODE_OPTIONS、echo $LD_PRELOAD、echo $PYTHONPATH；某些 Python 虚拟环境激活脚本会残留__PYVENV_LAUNCHER__，必须在启动 VSCode 前 unset - 长期修复：在 VSCode 的桌面快捷方式或启动脚本中显式清除变量，例如 Linux/macOS 的桌面文件中改
Exec=env -u NODE_OPTIONS -u LD_PRELOAD code %F
#!/bin/bash # 示例：Linux 下安全启动脚本（避免环境变量污染） unset NODE_OPTIONS unset LD_PRELOAD unset __PYVENV_LAUNCHER__ exec code --disable-extensions "$@"
有些问题不会立刻暴露，比如扩展缓存损坏可能只在某次更新后才触发；环境变量污染更隐蔽——它可能只影响 GUI 启动，而终端里 code . 却一切正常。动手前先做最小化复现，比盲目删配置更省时间。
