VSCode Markdown预览“卡顿”主因是配置不当或插件冲突：需确保文件已保存、禁用冗余渲染、合理设置滚动同步及自动保存，而非性能不足。
VSCode 内置 Markdown 预览本身不慢，但「看起来慢」往往是因为你没关掉冗余渲染、用了不匹配的插件，或者误启了同步滚动却没保存文件——这些都会让预览卡顿或延迟刷新。
为什么 Markdown 预览一滚动就卡、输入几秒才更新
这不是性能问题，而是触发条件缺失或配置冲突。VSCode 的预览刷新依赖两个前提：文件已保存（files.autoSave 设为 afterDelay 或手动按 Ctrl+S），且未被其他插件劫持渲染流程。
-
markdown.preview.autoRefresh默认为true，但如果装了Markdown All in One或Markdown Preview Enhanced，它可能被覆盖——检查设置搜索该字段，确认值是true - 未保存的编辑内容不会触发预览更新，哪怕开了
autoRefresh；files.autoSave设成off时，必须手动保存才能看到变化 - 同时启用
scrollEditorWithPreview和scrollPreviewWithEditor会导致滚动抖动，尤其文档超 2000 行时，建议只开其中一个 - Mermaid / MathJax 渲染会阻塞主线程；若文档不含图表或公式，在
settings.json中显式禁用："markdown-preview-enhanced.mermaid.enabled": false、"markdown-preview-enhanced.mathjax.enabled": false
侧边同步预览打不开？不是快捷键失效，是视图没“绑定”
VSCode 不会自动把预览“钉”在右侧，它只按命令逻辑打开视图，位置由你上次拖拽决定。所谓“侧边同步”，本质是预览视图嵌入右侧编辑器组，并由同一 Webview 实例承载。
- 首次使用
Ctrl+Shift+V（Windows/Linux）或Cmd+Shift+V（macOS）时，预览可能落在底部面板；拖住预览标签顶部横条 → 向右编辑器边缘靠近 → 出现蓝色竖线后松手，即可嵌入右侧 - 如果拖完仍不生效，检查
workbench.editor.openSideBySide是否为true（默认是），否则预览会强制新开窗口 - 用命令面板运行
Markdown: Open Preview to the Side比快捷键更可靠，尤其当输入法处于中文状态时，快捷键常被拦截 - 已打开原生预览页再装
Markdown Preview Enhanced，需关闭所有预览页并重启 VSCode，否则新插件无法接管视图
想真·实时预览？别依赖 autoRefresh，要靠 autoSave + 视图复用
markdown.preview.autoRefresh 只控制“保存后是否重载 WebView”，不是监听输入事件。真正的“边写边看”体验，靠的是快速保存 + 视图不销毁 + 渲染不重置。
- 设
files.autoSave为afterDelay，延迟建议1000ms（太短易触发频繁编译，太长感知滞后） - 禁用
workbench.editor.enablePreview（即单击文件不预览），避免每次点别的 .md 文件时，当前预览页被回收 - 不要反复关闭/重开预览页；保持同一个预览视图，VSCode 会在保存后直接复用 DOM 节点重绘，比新建快 3–5 倍
- 大文档（>5000 行）建议关闭
markdown.preview.scrollPreviewWithEditor，仅保留编辑器跟随预览滚动（即只开scrollEditorWithPreview），减少坐标映射计算开销
真正卡顿的根源，往往藏在「已保存但没触发刷新」和「多个插件抢着渲染」之间。先关掉所有 Markdown 相关插件，只留原生功能跑一次，再逐个开，就能定位谁在拖慢你。
