必须安装PDF Viewer（作者tomoki1207）插件，因其基于最新PDF.js、持续维护、无广告且兼容VSCode 1.85+；需禁用workbench.editor.enablePreview并排查中文路径、扫描版及超大文件等硬限制。
必须装对插件：认准 PDF Viewer（作者 tomoki1207）
VSCode 本身完全不支持 PDF 渲染，双击 .pdf 文件默认调用系统阅读器或报错“无法打开此文件”。唯一可靠方案是安装由 tomoki1207 维护的 PDF Viewer 扩展——它基于最新版 PDF.js，无广告、兼容 VSCode 1.85+，且持续更新。其他名称相似的扩展（如 vscode-pdf、PDF by chenxsan、vscode-pdfviewer 镜像）均已停更或存在卡死、白屏等严重问题。
关键配置项都在 pdf-preview 设置里
打开 VSCode 设置（Ctrl+Shift+P → 输入 Preferences: Open Settings (JSON)），在 JSON 中添加或修改以下字段：
-
"pdf-preview.default.scale"：控制初始缩放，推荐"page-width"（适配技术文档）、"page-fit"（整页可见）、"auto"（自动适配窗口） -
"pdf-preview.default.scrollMode"：滚动方式，"vertical"（长文档首选）、"horizontal"（宽表格）、"wrapped"（多列排版更自然） -
"pdf-preview.default.sidebar"：设为true可默认显示大纲/缩略图侧边栏，对带书签的 API 文档特别有用 -
"pdf-preview.default.cursor"：设为"select"启用文本选择复制，"hand"则是拖拽浏览模式
双击不常驻？关掉 VSCode 的预览标签机制
即使插件装好，双击仍可能只开一个临时标签页（点别的文件就关闭前一个），这是 VSCode 自身的编辑器预览机制在干扰，和插件无关。解决方法：
- 打开命令面板：
Ctrl+Shift+P - 输入并选择
Preferences: Open Settings (JSON) - 添加一行：
"workbench.editor.enablePreview": false - 保存即生效，无需重启
改完后双击 PDF 就会真正打开常驻标签页，支持固定、分栏、Ctrl+Tab 切换。
常见失效场景：先排查文件本身
缩放、搜索、翻页异常，大概率不是插件问题，而是 PDF 源文件有硬限制：
- 路径含中文或空格（如
./财务报表 2024.pdf）→ 移到纯英文路径再试 - 扫描版 PDF（纯图片）→ PDF.js 无法提取文字，必然白屏或模糊，需先 OCR 转文本
- 文件 >50MB 或加密 → 加载极慢甚至卡死，建议用
pdfsizeopt压缩或确认是否被密码保护 -
Ctrl+F搜索无效 → 多数是源文件未嵌入文本层，可先用 Chrome 打开同一文件验证
真正容易被忽略的是：PDF Viewer 不接管 Markdown 中的  链接跳转，点击无反应是正常行为；如需该功能，得配合 Markdown Preview Enhanced 等插件额外配置。
