VSCode默认Ctrl+Shift+V预览不更新因其为一次性快照,需开启自动保存并使用Markdown Preview Enhanced扩展实现真正的实时预览,同时合理配置数学公式、图片加载与SVG处理策略。
VSCode默认的
预览为什么经常不更新?
因为它是“一次性快照”,不是实时监听——只要文件没保存,或者编辑器焦点不在当前MD文件上,预览就不会刷新。尤其在写长文档、频繁插入图片或修改表格时,手动反复按快捷键非常打断节奏。
解决方法只有两个:开启自动保存 + 启用真正的实时预览扩展。别信某些教程说“改设置就能实时”,VSCode原生
只控制是否自动弹出面板,不解决刷新逻辑。
必须开启
(设为
或
)
禁用
,否则双击预览区会意外切回编辑器,中断渲染
如果用的是Remote-SSH,确保
为
,否则本地渲染引擎无法加载远程资源
推荐用
而不是
主打快捷键和大纲,预览只是附带功能;而
(简称MPE)从底层用Pandoc+WebView重构了渲染流程,支持数学公式、PlantUML、Mermaid实时解析,且能响应
事件自动重绘。
安装后关键配置项:
启用
:让未保存的草稿也能触发预览更新
把
设为
,避免默认主题字体过小或代码块背景发灰
若插入本地图片路径含中文,需确认
为
,否则脚本沙箱会拦截非ASCII路径
插件和
冲突导致公式不渲染?
VSCode里同时装了
和
,公式可能完全不显示,或只渲染第一次——这是因为两者都试图接管
和
语法,但MathJax初始化时机不同,后者会覆盖前者全局配置。
VSCode 1.118
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力,其中最引人注目的是新增 Copilot CLI 远程控制功能,允许开发者通过手机或网页远程监控和接管 AI 会话 。同时,为了提高 AI 的运行性价比,新版本优化了令牌缓存策略以降低成本 。此外,1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
下载
正确做法是二选一:
要LaTeX完整支持(如参考文献、交叉引用):卸载
,改用MPE内置的
配置,在
加:
仅需基础行内/块级公式:保留
,但关闭MPE的数学渲染:
→
预览窗口卡顿、滚动不同步、图片加载慢怎么办?
本质是WebView资源加载策略问题。VSCode的预览页本质是个精简版Chromium,但默认禁用硬件加速,且对大图不做懒加载。
实测有效的调优项:
在
中添加:
(关闭高亮可显著降低CPU占用)
图片超过2MB建议转WebP格式,并在MD中显式指定宽高:
,否则WebView会先加载全尺寸再缩放,拖慢首屏
禁用所有非必要插件(尤其是
、
),它们会向WebView注入额外CSS/JS,引发样式污染
真正麻烦的是嵌入SVG——它会被当作HTML片段直接插入,若含外部
或复杂滤镜,WebView可能拒绝执行或白屏。这种场景下,不如导出为PDF再查看。
Ctrl+Shift+Vmarkdown.preview.autoShowPreviewToSidefiles.autoSaveafterDelayonFocusChangemarkdown.preview.doubleClickToSwitchToEditormarkdown.preview.useWebviewtrueMarkdown Preview EnhancedMarkdown All in OneMarkdown All in OneMarkdown Preview Enhancedwatchmarkdown-preview-enhanced.enableExtendedAutosavemarkdown-preview-enhanced.previewThemegithub.cssmarkdown-preview-enhanced.enableScriptExecutionfalsemdmathMathJaxmdmathMarkdown Preview Enhanced$...$$$...$$mdmathmathjaxsettings.json"markdown-preview-enhanced.mathjaxConfig": {
"tex": {
"inlineMath": [['$', '$'], ['\(', '\)']],
"packages": {'[+]': ['ams', 'color']}
}
}mdmathmarkdown-preview-enhanced.enableMathfalsesettings.json"markdown-preview-enhanced.enableFileWatching": true,
"markdown-preview-enhanced.enableCodeBlockHighlighting": false{width="600px" height="400px"}PolacodeBracket Pair Colorizer