必须安装 pdf viewer（作者 tomoki1207）插件，因其持续维护、基于最新 pdf.js、无广告、兼容 vscode 1.85+；安装后需重启 vscode 才能启用右键 open preview 功能。
必须装插件，且只能用 PDF Viewer（作者 tomoki1207）——VSCode 本身完全不支持 PDF 渲染，双击 .pdf 文件默认调用系统阅读器或报错“无法打开此文件”。
装哪个插件？认准 PDF Viewer（作者 tomoki1207）
其他名字相似的都不可靠：vscode-pdf 是旧名已下架；PDF（by chenxsan）停更多年，加载大文件极易卡死；vscode-pdfviewer 是非官方镜像，更新滞后。只有 PDF Viewer 持续维护、基于最新 PDF.js、无广告、兼容 VSCode 1.85+ 的 WebView 渲染引擎。
安装后必须重启 VSCode，否则右键菜单不会出现 Open Preview 选项。验证方式：右键任意 .pdf 文件，菜单中能看到该条目即成功。
双击还是只开临时标签页？关掉 workbench.editor.enablePreview
即使插件装好，双击仍可能只开一个预览态标签页（点别的文件就关闭前一个），这是 VSCode 自身的 editor preview 机制在干扰，和插件无关。
解决方法：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入并选择
Preferences: Open Settings (JSON) - 在配置对象中添加：
"workbench.editor.enablePreview": false - 保存即可生效，无需重启
改完后双击 PDF 就会真正打开常驻标签页，支持固定、分栏、Ctrl+Tab 切换。
PDF 打不开 / 白屏 / 卡死？先查这三类硬限制
插件能力有明确边界，不是所有 PDF 都能渲染。遇到异常优先排查：
-
路径含中文或空格：如
./财务报表 2024.pdf，URI 编码处理不稳定 → 移到纯英文路径（如C:/docs/manual.pdf）再试 - 扫描版 PDF（纯图片）：PDF.js 无法提取文字和结构，可能白屏或仅显示模糊图层 → 插件无法 OCR，需先用工具转成可读文本
-
文件超大（>50MB）或加密：插件无压缩/解密逻辑 → 加载极慢甚至卡死，建议用
pdfsizeopt压缩，或确认是否被密码保护
缩放、搜索、翻页失效？别怪插件，先看源文件本身
PDF Viewer 依赖 Electron WebView 渲染，但很多交互能力取决于 PDF 文件自身结构：
-
Ctrl+F搜索无效 → 很可能是扫描版或未嵌入文本层，不是插件问题 - 文字模糊、表单按钮不可点 → 先用 Chrome 打开同一文件确认是否源文件就存在字体嵌入或 AcroForm 兼容性问题
- 点击 Markdown 中的
链接没反应 → 这是默认行为，PDF Viewer 不接管链接跳转；如需该功能，得配合Markdown Preview Enhanced等插件额外配置
最易被忽略的一点：VSCode 内置 WebView 对某些 PDF 特性（如嵌入的 Type 3 字体、复杂表单域）支持仍不稳定，这类问题往往不是重装插件能解决的，得回到 PDF 源头处理。
