扩展禁用预览命令的典型表现是右键菜单无“Open Preview”且命令面板搜不到该命令，主因是GitLens、Markdown All in One等插件劫持语言模式或覆盖注册逻辑；需检查右下角语言模式是否为标准Markdown、Console中搜索registerEditorAction确认命令注册状态，并通过禁用扩展逐个排查。
扩展禁用预览命令的典型表现
右键菜单里找不到 Open Preview，或命令面板搜不到该命令，不是设置没生效，而是某个扩展把预览功能注册逻辑给劫持或屏蔽了。常见于 GitLens、Markdown All in One、Obsidian Markdown 等插件——它们会重写语言模式或覆盖默认编辑器行为。
检查当前文件的语言模式：看右下角状态栏显示的是 Markdown 还是 Obsidian Markdown；后者会导致 VSCode 根本不加载内置的 markdown.preview 视图。
打开开发者工具（Developer: Toggle Developer Tools），在 Console 里搜索 registerEditorAction 或 preview，如果没输出对应注册日志，说明相关命令压根没被激活。
- 临时禁用所有扩展，再逐个启用，定位干扰源
- 对 Markdown 文件，执行
Change Language Mode（Ctrl+K M），手动切回Markdown再试预览 - 某些扩展（如 Markdown Preview Enhanced）自带独立预览命令，它不会响应 VSCode 原生的
Open Preview
扩展主动调用预览 API 的绕过行为
即使你已设 "workbench.editor.enablePreview": false，GitLens 的 blame 行点击、Todo Tree 的任务跳转、甚至 Remote-SSH 的文件双击，仍可能弹出斜体标签——因为这些扩展直接调用了 vscode.window.showTextDocument 并传入 { preview: true } 参数，完全绕过全局开关。
这类行为无法靠用户设置拦截，必须查扩展文档找对应配置项。例如：
- GitLens：检查
gitlens.views.fileHistory.location和gitlens.codeLens.enabled，部分版本需设gitlens.advanced.legacyFileHistory为false - Todo Tree：确认
todo-tree.tree.hideWhenEmpty不影响跳转逻辑，部分版本需关闭todo-tree.general.openInPreview - Remote-SSH：升级到 v0.106+ 后，其文件浏览器默认走
enablePreviewFromExplorer控制，但旧版硬编码为true
扩展与预览生命周期冲突的静默失败
预览窗口打开但内容空白，尤其是 Mermaid/PlantUML/HTML 渲染失败，大概率不是渲染器问题，而是扩展注入的脚本或样式污染了预览 iframe 的上下文。比如某主题扩展强制重写 document.head，或某 LSP 客户端往全局注入了冲突的 Promise polyfill。
验证方式：禁用所有非必要扩展后，用 Mermaid Preview: Toggle Preview 手动触发一次，观察右下角是否显示 Mermaid 而非 plaintext；若仍空白，再开开发者工具，切换到 Preview 标签页的 Console，看是否有 ReferenceError 或 Cross-Origin Read Blocking 报错。
- HTML 预览白屏时，先确认是否用了
file://协议——扩展无法绕过浏览器安全策略 - PlantUML 报
Java not found，不是 Java 没装，而是扩展读取的plantuml.java路径被其他扩展覆盖（如某些 Java 工具链扩展会重写java.home） - Mermaid 渲染卡住，检查是否同时启用了多个 Mermaid 扩展（如 Mermaid Preview + Markdown Preview Enhanced），它们会竞争同一全局变量
mermaidAPI
settings.json 中被扩展覆盖的关键字段
某些扩展会在工作区根目录下生成 .vscode/settings.json，并悄悄写入与预览相关的字段，优先级高于用户设置。比如一个团队共享的配置可能包含：
"workbench.editor.enablePreview": true,
"workbench.editor.enablePreviewFromQuickOpen": true,
"workbench.editorAssociations": [{ "viewType": "markdown.preview", "filenamePattern": "*.md" }]
这种写法会让 .md 强制走预览视图，哪怕你用户级设了 false 也无效。更隐蔽的是，有些扩展通过 WorkspaceConfiguration.update() API 动态写配置，重启后才生效，导致你反复修改 settings.json 却没变化。
- 打开命令面板，运行
Preferences: Open Workspace Settings (JSON)，检查是否存在上述字段 - 用
Ctrl+Shift+P→Developer: Inspect Editor Tokens and Scopes，点预览标签页，看右上角显示的View Type是default还是markdown.preview - 若发现
viewType异常，说明workbench.editorAssociations或扩展的contributes.views在起作用
真正要小心的是：预览模式失效时，VSCode 很少报错，多数是静默降级——比如该预览的变常驻、该渲染的变空白、该出现的命令直接消失。排查顺序一定是「先关扩展、再查设置层级、最后盯住 View Type 和 Console 日志」。
