PDF Viewer 打不开大 PDF 是因 PDF.js 渲染引擎限制：非流式加载、内存超限（>50MB 易触发 V8 堆溢出）、中文路径被拦截、扫描件无文本层；需用 qpdf 压缩、纯英文路径、确认无 DRM，并优先采用系统预览器或 SumatraPDF 等替代方案。
PDF Viewer 插件本身不支持打开超 50MB 的 PDF，这不是插件故障，而是底层 PDF.js 渲染引擎的内存与解析限制；强行加载会导致白屏、CPU 飙高或标签页无响应，必须从文件预处理、路径规范和 VSCode 启动方式三方面协同解决。
为什么 PDF Viewer 打不开大 PDF？
PDF Viewer 基于浏览器级 PDF.js，它把整个 PDF 解析为 canvas 渲染帧——不是流式读取。这意味着：
- 文件体积 > 50MB 时，内存分配极易触发 V8 heap out of memory（尤其 macOS/Linux 上 Electron 默认堆上限约 1.4GB）
- 扫描版 PDF（无文本层）会卡在 OCR 模拟阶段，报
Failed to load PDF file或长时间 spinning - 路径含中文、空格或括号（如
/Users/张三/项目(测试)/manual.pdf）会导致 PDF.js 的fetch()请求被 Electron 底层拦截，静默失败 - 即使插件启用、VSCode 重启、
workbench.editor.enablePreview关闭，这些硬性限制仍存在
怎么让大 PDF 在 VSCode 里真正显示？
别指望靠改配置硬扛，直接做减法：
- 用
qpdf --stream-data=none input.pdf output.pdf压缩去除冗余流（实测可将 82MB 扫描 PDF 缩至 12MB，且保留可读性） - 把文件移到纯英文路径下，例如
/tmp/manual.pdf或C:/vscode-pdfs/manual.pdf - 确认 PDF 无 DRM 加密：用系统预览器（macOS）或 SumatraPDF（Windows）能打开，才说明文件本身合法
- 若仍是扫描件，PDF Viewer 无法提取文字——此时它本就不该是主力工具，切出去用专业 OCR 软件更实际
VSCode 启动参数能绕过 PDF 加载失败吗？
不能。VSCode 的 --read-only、--disable-extensions 等参数只影响文本编辑器管线，对 PDF Viewer 这类 Webview 插件完全无效——它的渲染进程独立于主编辑器，不受命令行参数控制。
唯一能干预的方式是：在 VSCode 启动前，确保 PDF 文件已满足 PDF.js 的基础要求（纯英文路径 + 非扫描 + ≤50MB）。否则，哪怕你禁用全部扩展，双击后仍是白屏或报错 Failed to load PDF file。
替代方案比硬调 PDF Viewer 更可靠
当 PDF 超过 30MB 或含扫描内容时，与其反复调试插件，不如换路径：
- 用系统自带预览器（macOS Quick Look / Windows Edge）配合
Cmd+Space或Win+D快速呼出，搜索跳转更快 - 在 VSCode 中右键 →
Reveal in Finder（macOS）或Open in File Explorer（Windows），直接双击用 SumatraPDF 打开——它启动快、内存低、支持书签和文本复制 - 需要查 API 文档？优先用官方在线版（如 Rust std docs、React docs），VSCode 内联预览只是备选，不是刚需
真正卡住的点，往往是你试图让一个文档查看器承担编辑器的职责——PDF Viewer 是为技术手册这类结构清晰、体积适中的 PDF 设计的，不是为 GB 级扫描档案服务的。
