vscode“快速预览模式”需同时满足三个条件:workbench.tree.expandmode设为singleclick、workbench.editor.enablepreview和workbench.editor.preview均为true,缺一不可;否则空格或点击均退化为常驻打开。

VSCode 的“快速预览模式”不是单一开关,而是由三个独立设置协同控制的机制——关掉任意一个,按空格或点击文件都只会常驻打开,不会预览。
资源管理器按空格预览不生效?检查 workbench.tree.expandMode
这是最常被忽略的设置。VSCode 默认是 doubleClick,意味着你必须双击才打开文件;而空格键预览依赖的是单击行为触发的“预览态”。
- 打开设置(
Ctrl+,),搜索workbench.tree.expandMode - 把它改成
singleClick(不是doubleClick) - 改完立刻生效,无需重启
如果仍无效,说明其他设置也被动影响了行为。
预览标签页一打开就消失?确认 workbench.editor.enablePreview
这个设置决定“点击/空格后打开的是临时预览标签,还是常驻编辑器标签”。设为 false 时,所有预览都会退化为普通打开——标签名不斜体、关掉就丢内容、无法被后续点击覆盖。
- 在设置中搜
workbench.editor.enablePreview - 确保值为
true(默认开启,但 Remote-SSH 或某些配置同步工具可能重置它) - 顺手检查
workbench.editor.preview也应为true,它控制从资源管理器触发时是否走预览流程
这两个布尔值必须同时为 true,空格预览才能真正“预览”而不是“打开”。
Markdown 或 HTML 文件点不开预览?看语言模式和文件后缀
预览功能对文件类型有硬性要求:不是所有文本文件都能预览,也不是所有 .md 文件都能被识别为 Markdown。
- 右下角状态栏必须显示
Markdown,不能是Plain Text或Markdown (GitHub)—— 后者是插件提供的语言模式,原生预览不认 - 文件后缀必须是
.md(小写),.markdown需额外配置markdown.preview.markdownFileExtensions - HTML 文件要预览,得用内置的
Open in Integrated Browser(右键菜单或编辑器右上角 ?️ 图标),不是Ctrl+Shift+V—— 后者只对 Markdown 生效
常见陷阱:把 .txt 改成 .md 但没切换语言模式,VSCode 仍当纯文本处理,预览按钮灰掉。
快捷键 Ctrl+Shift+V 没反应?优先排查插件劫持
这个快捷键极其容易被 Vim / Emacs 插件、键盘映射扩展或自定义 keybindings 覆盖。它不像系统级快捷键那样稳定。
- 临时禁用所有插件,再试
Ctrl+Shift+V;若恢复,说明某个插件劫持了该组合键 - 打开命令面板(
Ctrl+Shift+P),输入Markdown: Open Preview to the Side手动触发,验证功能本身是否正常 - 检查
keybindings.json是否存在"key": "ctrl+shift+v"的自定义规则(尤其 Vim 插件常绑定此键为粘贴)
真正可靠的触发方式永远是命令面板或右键菜单——快捷键只是锦上添花,不是基础设施。
复杂点在于:这三个设置彼此不报错也不提示依赖关系,关掉一个,其他两个照常运行,但整体行为就崩了。最容易被忽略的是 workbench.tree.expandMode,因为它藏得深、名字不直观,且修改后没有视觉反馈。











