VSCode“文件预览模式”分两种:一是标签页斜体临时预览(禁用workbench.editor.enablePreview即可关闭),二是Markdown/HTML等渲染预览(用Ctrl+Shift+V触发,依赖.md后缀、markdown.preview.enabled开启及保存刷新)。

VSCode 里说的“文件预览模式”其实分两种完全不同的场景:一种是编辑器标签页里的「临时预览」(单击文件斜体显示、再点别的就覆盖),另一种是针对特定文件类型(如 Markdown、HTML、PDF)打开渲染后的只读视图。你按的是哪一种?下面分开说清。
怎么关掉“单击文件就斜体预览”的行为
这不是你想预览什么内容,而是 VSCode 默认把资源管理器里单击的文件当成“临时预览”,标签名斜体、不占固定位置——再点别的文件,它就被顶掉。很多人误以为这是“开启了预览”,其实是编辑器标签管理逻辑。
-
workbench.editor.enablePreview设为false就彻底禁用:打开设置(Ctrl+,),搜这个配置项,取消勾选 - 若只想控制来源,比如资源管理器里点不预览、但命令面板里打开仍预览,可单独设
workbench.editor.enablePreviewFromExplorer为false - 改完不用重启,立即生效;已打开的斜体标签会自动转成实心固定标签
怎么打开 Markdown 文件的渲染预览
这才是大多数人真正想问的“预览”:写完 README.md,想立刻看标题、列表、代码块长什么样。
- 快捷键是
Ctrl+Shift+V(Windows/Linux)或Cmd+Shift+V(macOS)——Ctrl+K V是旧版快捷键,2026 年主流版本已弃用,按了没反应属正常 - 必须满足三个前提:当前文件后缀是
.md、右下角语言模式显示 “Markdown”(不是 “Plain Text”)、markdown.preview.enabled为true(Remote-SSH 环境下可能被重置) - 改了内容不刷新?不是 bug,是设计:预览只读磁盘文件,必须先
Ctrl+S保存,它才更新;files.autoSave设为onFocusChange可缓解,但绕不过“保存即刷新”这个前提
怎么预览 HTML 文件(不用插件)
VSCode 1.121 起内置了集成浏览器,index.html 这类文件根本不需要装 Live Server 插件。
- 右键资源管理器里的
.html文件 → 选 “Open in Integrated Browser” - 或打开 HTML 文件后,点编辑器标签右上角那个半透明的 ?️ 图标
- 它基于 Chromium 定制,改完代码保存,预览面板 200ms 内自动刷新,且暗黑模式、代理配置都和编辑器同步
- 注意:这个功能只对
.html、.htm后缀生效,.xhtml或自定义后缀需手动关联语言模式
PDF / Office 文件预览依赖插件,但配置很关键
VSCode 原生不支持 PDF 或 Excel 预览,得靠插件,但装完不等于能用——默认行为常让人困惑。
-
vscode-pdfviewer:双击 PDF 即可打开,但默认光标是文本选择态;想拖拽翻页,得设pdf-preview.default.cursor为"hand" -
vscode-office:能开.xlsx和.docx,但只是轻量解析——公式不计算、宏不运行、复杂样式会降级,别当真 Office 替代品 - 所有这类插件的预览窗口都是独立进程,滚动、缩放、焦点都不和编辑器联动,同步滚动要各自找对应设置项(比如 PDF 没有
markdown.preview.scrollPreviewWithEditor这种东西)
最易被忽略的一点:预览窗口右上角的三个点菜单里,“Sync Scrolling” 这个开关,只对 Markdown 有效;HTML 预览靠的是文件系统监听,PDF/Office 则压根不支持同步滚动——不是你没开对,是它们根本没实现这个能力。


















