pdf viewer（tomoki1207）是唯一推荐的中文pdf内联预览插件，基于最新pdf.js，兼容cjk字体与非标准编码；需禁用workbench.editor.enablepreview并排查中文路径、扫描版及超大文件等硬限制。
VSCode 本身不支持中文 PDF 或长文本文档的内联阅读，必须靠插件补足——但不是所有“PDF 阅读插件”都适合中文技术文档场景，关键得看渲染稳定性、路径兼容性和内存控制能力。
PDF Viewer（tomoki1207）是唯一推荐的 PDF 内联预览方案
它基于最新版 PDF.js，对中文字符集、CJK 字体嵌入、非标准编码 PDF 的兼容性远超其他同类插件。别被名字误导：vscode-pdf 是它的旧名，已下架；PDF（by chenxsan）停更多年；vscode-pdfviewer 是非官方镜像，更新滞后且存在安全风险。
- 安装后必须重启 VSCode，否则右键菜单不会出现
Open Preview - 图标是蓝白 PDF 标志，作者栏明确显示
tomoki1207，这是验证真伪的最快方式 - 默认双击仍开预览标签页？不是插件问题，而是 VSCode 自身机制干扰，需手动关掉
workbench.editor.enablePreview
workbench.editor.enablePreview: false 必须加进 settings.json
即使插件装好了，双击 PDF 还是闪退或只开临时标签页，大概率是这个配置没关。它和插件无关，是 VSCode 编辑器层的“预览模式”在抢控制权。
- 快捷键
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入并选择
Preferences: Open Settings (JSON) - 在
{}内添加一行："workbench.editor.enablePreview": false - 保存即生效，无需重启，之后双击 PDF 就会常驻打开、可固定、可分栏、可
Ctrl+Tab切换
中文路径、扫描版、超大 PDF 渲染失败？先查这三类硬限制
插件再强也有边界，遇到白屏、卡死、文字乱码，优先排查底层环境问题，而不是怀疑插件本身。
-
路径含中文或空格：VSCode 对 URI 编码处理不稳定，把 PDF 移到纯英文路径（如C:/docs/manual.pdf）再试 -
扫描版 PDF（图片型）：PDF.js 无法提取文字结构，只会渲染模糊图层甚至白屏；这类文件建议先用 OCR 工具转成可选中文文本再导入 -
超大文件（>100MB）或加密 PDF：插件未实现流式加载，容易内存溢出卡死；可用qpdf --stream-data=none拆解压缩流后再试
Thief-Book 更适合纯文本中文阅读（如 API 文档、小说、笔记）
如果你主要读的是 .txt、.md 等纯文本格式的中文资料，Thief-Book 比 PDF 插件更轻、更快、更可控。
- 必须用
UTF-8编码保存源文件，否则中文直接乱码 - 路径填绝对路径（如
C:\docs\api-ref.txt），相对路径不支持 - 翻页失灵？大概率是快捷键冲突，比如
Ctrl+M和终端聚焦冲突，建议改用Ctrl+Alt+M等组合 - 不支持 PDF，也不做语法高亮，专注分页阅读与状态隐藏，老板路过时按一下就切回代码界面
真正麻烦的从来不是“装哪个插件”，而是路径编码、字体嵌入、内存限制这些底层细节——它们不出现在插件介绍里，却决定你能不能安稳读完一页中文文档。
