必须安装插件才能在vscode中预览pdf,原生不支持;唯一稳定选择是tomoki1207发布的vscode-pdf(非vscode-pdfviewer或pdf by chenxsan),安装后需全量重启,右键出现open preview即生效。

能,但必须装扩展,原生 VSCode 不支持 PDF 渲染。 安装 vscode-pdf(作者 tomoki1207)是最稳定、轻量、无广告的选择;vscode-office(cweijan)也能看 PDF,但它是多功能插件,PDF 只是其中一环,启动略慢、权限更多、偶尔有兼容问题。
为什么双击 PDF 文件没反应?
VSCode 默认把 .pdf 当作二进制文件处理,只显示乱码或提示“无法预览”。它不内置 PDF 解析器,也不调用系统默认阅读器——这是设计使然,不是 bug。
- 直接双击 → 显示十六进制或乱码内容(
file is binary and cannot be displayed) - 右键 → “Open With” 菜单里没有 PDF 预览项,说明扩展未安装或未激活
- 即使装了扩展,首次打开仍可能弹出“选择打开方式”提示,选错一次后 VSCode 会记住,后续自动用错误方式打开
vscode-pdf 扩展安装与基础启用
别搜“PDF Preview”,容易装错(有同名但已废弃或功能残缺的扩展)。认准作者 tomoki1207 和仓库名 vscode-pdfviewer。
- 快捷安装:按
Ctrl+Shift+X打开扩展面板,搜vscode-pdf,点“Install”,重启 VSCode - 验证是否生效:在资源管理器中右键任意
.pdf文件,菜单中应出现Open Preview选项 - 若仍无效,检查是否被其他插件干扰(如某些主题或语言包会覆盖文件关联),可临时禁用非必要插件测试
- 安装后无需额外配置即可使用,但默认缩放是
auto,大屏下文字可能偏小,建议进设置搜pdf-preview.default.scale改为page-width
vscode-pdf 和 vscode-office 看 PDF 的实际差异
两者都能打开 PDF,但底层行为和适用场景不同:
-
vscode-pdf是专用 PDF 预览器,基于 PDF.js,启动快、内存占用低、滚动顺滑,适合高频查阅技术文档 -
vscode-office是多格式查看器,PDF 渲染依赖同一套引擎但封装更深,首次加载稍慢,且会请求更多权限(如访问本地文件系统、网络),部分企业环境策略会拦截 - 快捷键冲突:两者都支持
Ctrl+K V,但vscode-office默认绑定的是Ctrl+Shift+V(侧边打开),易混淆 - 搜索功能:两者都支持
Ctrl+F,但vscode-pdf的搜索高亮更稳定,vscode-office在含扫描图的 PDF 中可能漏匹配文本
真正容易被忽略的点是:PDF 内嵌字体或加密(哪怕只是“禁止复制”级别)会导致部分文字无法搜索或渲染异常,这不是插件问题,而是 PDF.js 的限制。遇到这种情况,别急着换插件,先用 Adobe Acrobat 或浏览器打开确认原文是否可选中——如果连浏览器都识别不了,那问题出在源文件本身。











