VSCode 默认不支持 PDF 内联预览,需安装 tomoki1207 开发的 PDF Viewer 插件并重启才能启用右键 Open Preview 功能;注意避开已停更插件,路径含中文或空格、扫描版PDF、超大文件均会导致渲染异常。
VSCode 默认不支持 PDF 预览,必须装插件
VSCode 本身没有内置 PDF 渲染能力,双击
文件只会提示“无法打开此文件”,或用系统默认程序打开——这不是你想要的内联预览。真正能实现在编辑器右侧/新标签页里直接渲染 PDF 的,只有靠第三方插件,目前最稳定、更新勤、无广告的是
(作者是 tomoki1207)。
注意:别装错名字相近的插件,比如
(by chenxsan)已多年未更新,加载大文件容易卡死;
(by tomoki1207 的旧名)已下架,新版本统一叫
。
安装 PDF Viewer 插件的正确步骤
在 VSCode 扩展市场搜
,认准发布者是
,点击安装后**必须重启 VSCode**——这是最容易被跳过的一步。不重启,右键
文件仍看不到
选项。
安装后,直接双击项目里的
,会自动在新编辑器标签页中渲染(不是弹窗)
右键任意
文件 → 选
,也可手动触发
如果右键没这个菜单,先检查是否重启 VSCode,再确认插件状态是否为“已启用”
预览时缩放/翻页/搜索失效?检查文件路径和编码
PDF Viewer 依赖浏览器内核(Electron WebView)渲染,对路径敏感。常见问题包括:
VSCode 1.118
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力,其中最引人注目的是新增 Copilot CLI 远程控制功能,允许开发者通过手机或网页远程监控和接管 AI 会话 。同时,为了提高 AI 的运行性价比,新版本优化了令牌缓存策略以降低成本 。此外,1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
下载
相对路径含中文或空格(如
)→ 渲染失败或白屏 → 改用英文命名或 URL 编码(不推荐),更稳妥是把 PDF 放到工作区根目录下
PDF 是扫描版(纯图片,无文本层)→
搜索无效,这是 PDF 本身限制,插件无法 OCR
文件大于 50MB → 加载极慢甚至卡死 → 插件无压缩机制,建议用
或在线工具先压缩
想让 PDF 和 Markdown 一起预览?需要额外配置
默认情况下,
不会响应 Markdown 里的
链接点击。要实现点击即预览,得手动加一条设置:
但这只是控制默认缩放方式。真正让链接可点,需配合
插件,或改用
+ 自定义命令绑定——不过这已超出 PDF Viewer 单一插件能力范围。简单场景下,直接双击资源管理器里的 PDF 更可靠。
复杂点在于:PDF 渲染质量取决于 Electron 版本,VSCode 1.85+ 内置的 WebView 对某些字体嵌入或表单域支持仍不稳定,遇到文字模糊或按钮不可点,别急着换插件,先试下用 Chrome 打开同一文件确认是不是源文件问题。
.pdfPDF ViewerPDFvscode-pdfPDF ViewerPDF Viewertomoki1207.pdfOpen Previewreport.pdf.pdfOpen Preview./财务报表 2024.pdfCtrl+FpdfsizeoptPDF Viewer"pdfviewer.defaultViewMode": "fitWidth"Markdown Preview EnhancedMarkdown All in One