根本原因是VSCode默认不支持PDF渲染，必须安装PDF Viewer（作者tomoki1207）插件并重启，同时在settings.json中配置"workbench.editorAssociations": {"*.pdf": "pdf.preview"}，否则.pdf文件将被当作二进制文件处理而触发下载或调用系统阅读器。
为什么PDF在VSCode里点开是下载而不是预览
根本原因是文件没有被识别为可预览类型，或当前扩展未接管该文件的打开逻辑。VSCode默认对.pdf不启用内置预览（它本身不带PDF渲染能力），必须依赖第三方扩展如vscode-pdf或vscode-office注册自定义编辑器才能触发预览行为。
- 确认已安装并启用
vscode-pdf（作者tomoki1207）或vscode-office，二者都基于pdf.js实现预览 - 检查是否误禁用了扩展：右键PDF文件 → “Open With” → 确保选中的是
PDF Preview或Office Viewer，而非Default Editor - 若使用
vscode-office，注意它会覆盖更多格式（包括.xlsx、.docx），但可能与vscode-pdf冲突，建议只保留一个 - 某些企业版或定制版VSCode（如GitHub Codespaces）可能禁用自定义编辑器权限，需检查
security.allowedModes设置
如何让双击PDF自动进预览页而非新标签页打开源文件
VSCode的“双击打开”行为由workbench.editorAssociations控制，它决定哪种文件类型该用哪个编辑器打开。默认情况下，.pdf未被显式关联，系统 fallback 到二进制文件处理逻辑，结果就是下载或用外部程序打开。
- 在
settings.json中添加：{ "workbench.editorAssociations": { "*.pdf": "vscode-pdf.previewEditor" } } - 若用
vscode-office，对应值为"vscode-office.pdfPreview"；可通过命令面板运行Developer: Inspect Editor Associations查看当前注册名 - 修改后无需重启，但已打开的PDF标签页需手动右键 → “Reopen with…” 才生效
- 注意：该配置仅影响新打开动作，不影响已打开的编辑器实例
预览页面无法交互（不能选中文本、不能复制、搜索失灵）
这是pdf.js渲染层与VSCode安全沙箱之间的典型权限限制。预览器运行在受限的Webview上下文中，部分DOM操作（如document.execCommand）被禁用，导致文本选择和复制功能失效。
- 确保PDF本身不是扫描件（即无真实文字层）：可在浏览器中打开同一文件测试能否选中文字
- 检查是否启用了
pdf-preview.enableTextSelection（vscode-pdf特有配置），设为true可尝试恢复基础选择能力 -
vscode-office对文本选择支持更好，但搜索功能仍受限于PDF元数据完整性；若PDF由LaTeX生成，建议加-shell-escape参数重编译以嵌入完整文本索引 - 避免在远程开发（SSH/Dev Containers）中使用
vscode-pdf，其Webview资源加载路径易因代理或CSP策略中断
缩放/滚动/工具栏按钮点击无响应
这类UI冻结通常不是扩展bug，而是VSCode的Webview资源调度问题——特别是当PDF页数多、含大量矢量图或嵌入字体时，pdf.js主线程被阻塞，导致事件队列堆积。
- 优先尝试降低渲染负载：在设置中将
pdf-preview.default.scale设为"page-width"而非"auto"，避免动态重排 - 关闭不必要的侧边栏：
"pdf-preview.default.sidebar": false，减少DOM节点数量 - 若用
vscode-office，其Excel/Word预览共用同一Webview实例，打开多个大文件时容易争抢资源，建议单次只预览一种类型 - Windows用户注意：启用GPU加速（
settings.json中加"window.experimental.useSandbox": false）有时能缓解，但会降低安全性
