vscode黑屏基本可判定是插件或gpu问题，非配置损坏；先运行code --disable-gpu验证，若恢复正常则为gpu加速与显卡驱动不兼容；否则执行code --disable-extensions排查插件，重点检查shd101wyy.markdown-preview-enhanced等markdown预览插件是否引发extension host崩溃。
黑屏基本可判定是插件或GPU问题，不是配置损坏
VSCode 启动后窗口全黑、光标能动但无任何 UI 元素，大概率不是 settings.json 写错了，而是渲染流程在早期就被中断。常见诱因有两个：一是某个 Markdown 预览插件（比如 shd101wyy.markdown-preview-enhanced 或 yzane.markdown-pdf）在初始化时触发 extension host 崩溃；二是 GPU 加速与显卡驱动不兼容，导致主窗口无法绘制。先用 code --disable-gpu 快速验证——如果这时能正常显示，就不用往下排查插件了。
确认是否为 Markdown 插件导致崩溃
别打开扩展面板，它可能根本加载不出来。终端执行以下命令：
-
code --disable-extensions：若此时能正常启动，说明 100% 是插件问题 -
code --list-extensions | grep -i markdown：快速筛出所有 Markdown 相关插件，如shd101wyy.markdown-preview-enhanced、DavidAnson.vscode-markdownlint、bierner.markdown-checkbox -
code --disable-extension shd101wyy.markdown-preview-enhanced：逐个禁用，尤其优先试这个——它是崩溃高频源，常因 MathJax 加载失败或 Kroki 服务超时卡死 extension host
注意：--disable-extension 只跳过激活，不删除文件；某些旧版插件（如 v0.5.x 的 markdown-preview-enhanced）即使被禁用，仍会尝试读取 argv.json 或 patch main.js，导致崩溃照旧。这种情况下必须手动删目录。
手动清理崩溃插件的残留文件
禁用无效时，直接物理移除插件文件夹：
文档转 Markdown 转换器 - 将 DOCX、PPTX、Excel 文件转换为 Markdown。用于从 Word 文档、PowerPoint 演示文稿或 E... 提取内容。
- Linux/macOS：
rm -rf ~/.vscode/extensions/shd101wyy.markdown-preview-enhanced-* - Windows：
%USERPROFILE%\.vscode\extensions\shd101wyy.markdown-preview-enhanced-*（进资源管理器粘贴路径，删整个文件夹）
删完不用重启系统，直接运行 code 即可。VSCode 启动时发现目录不存在，会自动跳过加载逻辑。如果还黑屏，说明问题不在这个插件，换下一个疑似对象（比如 yzane.markdown-pdf）重复操作。
避免预览插件冲突的硬性约束
多个 Markdown 预览插件共存极易引发命令注册冲突或资源争抢，尤其是都监听 Ctrl+Shift+V 时：
- 不要同时启用
shd101wyy.markdown-preview-enhanced和bierner.markdown-preview-github-styles，后者会覆盖前者样式注入机制 -
markdown-preview-enhanced的mathjaxV3ScriptSrc若指向国内 CDN 且网络不通，它不会报错，而是让 extension host 静默挂起 30 秒再崩 - 检查
settings.json中是否误配了markdown-preview-enhanced.plantumlJarPath——路径不存在时，该插件会在启动阶段反复重试并阻塞主线程
真正容易被忽略的是：插件崩溃日志不会出现在输出面板里，而是在开发者工具控制台（Ctrl+Shift+I → Console 标签页）中刷 Extension host terminated unexpectedly。只要没开这个看一眼，就永远不知道是哪个插件在后台把进程干掉了。
