vscode-office 和 Office Viewer 是同一插件（作者 cweijan）在 Marketplace 的不同名称，安装任一即可；需避开已停更的旧版 office-viewer（作者 John P. R. Foster），否则易报解析错误且不支持 CSV 编辑。
VSCode 本身不原生支持 Office、PDF、SVG 等非文本文件的可视化预览，必须依赖插件；但不同插件能力差异极大，选错会导致文件打不开、预览卡死、修改后不刷新，甚至拖慢整个编辑器。
vscode-office 和 Office Viewer 到底该装哪个？
两者核心功能高度重合，但维护状态和底层依赖不同：vscode-office（作者 cweijan）是当前活跃维护的主力方案，下载量超 114 万，GitHub 持续更新至 2026 年；Office Viewer（作者 cweijan）实为同一项目在 Marketplace 的别名，不是另一个插件——安装任一即可，无需共存。
容易踩的坑：
- 搜“Office Viewer”时会混入旧版
office-viewer（作者 John P. R. Foster），它已多年未更新，.xlsx打开常报Error: Failed to parse workbook，且不支持.csv编辑 - 装完插件后双击
.docx仍用文本模式打开 → 检查是否被其他扩展（如Markdown All in One）劫持了默认编辑器，右键文件 → “Reopen with” → 选 “Office Editor” - Linux 下打开
.xlsx报错libglib-2.0.so.0: cannot open shared object file→ 运行lib/linux.sh脚本补全系统依赖，不是插件 bug
SVG 预览为什么改了代码不刷新？
SVG Viewer（作者 cssho）是目前唯一稳定支持现代 SVG 特性的独立渲染器，但它只监听独立 .svg 文件变更，对 HTML 内联 <svg></svg> 或 .html 中的 <img src="xxx.svg" alt="VSCode插件支持的多种文件预览方案" > 完全无感。
常见失效场景：
-
.svg文件正被 Figma、Sketch、Chrome 占用 → 关闭外部程序再保存，否则 VSCode 读不到最新内容 - 你编辑的是
index.html里的内联 SVG → 此时需用浏览器实时预览，或改用Live Server插件配合手动刷新 - 用了
<use href="#icon"></use>引用外部<defs></defs>→ 旧版SVG Preview（作者 John P. R. Foster）直接白屏，SVG Viewer支持，但要求引用路径为相对路径且在同一项目内
PDF 预览卡顿或文字无法选择？
VSCode 内建 PDF 渲染能力极弱，必须装专用插件。推荐 vscode-pdfviewer（基于 Mozilla pdf.js），而非依赖 vscode-office 自带的 PDF 模块——后者在大文件（>50MB）或含复杂矢量图的 PDF 上易崩溃。
关键配置点：
- 启用文本选择：在设置中搜索
pdfjs.textLayer，确保值为true - 禁用硬件加速（仅 Windows）：若滚动卡顿，添加启动参数
--disable-gpu到 VSCode 快捷方式目标中 - 多页 PDF 导航慢 →
vscode-pdfviewer默认加载全部页面，可右键预览区 → “Go to Page…” 直接跳转，避免滑动
图片预览要悬停看缩略图，还是双击全屏？
Image Preview 提供悬停即显的轻量方案，适合快速确认图标、截图是否正确；vscode-office 和 vscode-pdfviewer 则提供双击全屏、缩放、导出 PNG 等完整操作——二者不冲突，可共存，按需触发。
注意兼容性细节：
-
Image Preview不支持.webp动画帧，.gif也不自动播放；vscode-office支持静态.webp，但动画.gif仅显示首帧 - 想边写 Markdown 边看图表？
Markdown Preview Enhanced支持实时渲染，但需开启markdown-preview-enhanced.enableExtendedAutoreload - 大尺寸图片（如 4K 截图）在
vscode-office中可能内存溢出 → 改用系统默认图片查看器，右键 → “Reveal in Explorer” 后双击打开
真正麻烦的从来不是装哪个插件，而是搞清每个插件的监听边界：它只管什么、不管什么、在什么条件下失效。比如 SVG Viewer 不处理 HTML 里的 SVG，vscode-office 不接管 .http 文件的 REST 请求发送——这些边界不厘清，调试起来永远像在猜谜。
