输入 : 可强制聚焦 vscode 最近文档列表，避开模糊匹配干扰；通过软链接固定 docs/ 目录、项目级 pdf 配置及 vscode-pdfviewer 原生搜索，提升非代码文档访问效率。
Ctrl+P 输入 : 直接唤出最近文档列表
VSCode 默认把最近打开的文件（包括 PDF、MD、TXT 等非代码文档）优先排在 Ctrl+P 结果顶部，但很多人没意识到输入 : 会强制聚焦到“最近”分类——它比单纯按 Ctrl+P 更可靠，尤其当项目里有大量同名文件时，能避开模糊匹配干扰。
常见错误现象：输完 Ctrl+P 后直接打文件名，结果跳出一堆匹配项，反而找不到刚看过的 API 手册 PDF；或者误按 Ctrl+R 只看到文件夹，漏掉单个文档。
-
Ctrl+P→ 输入:→ 回车，列表清一色是最近打开的文档（含时间戳） - 支持上下键选择，回车打开；也可输入部分文件名进一步过滤（如
:api） - PDF 文档需已用
vscode-pdfviewer插件打开过一次，否则不会进该列表
把常用文档固定到资源管理器顶部（无需插件）
VSCode 的资源管理器不支持拖拽置顶，但可以用 .vscode/settings.json 配合 files.exclude 和符号链接“伪装”常驻入口。实际做法更轻量：在项目根目录建一个 docs/ 软链接，指向你高频查阅的文档所在路径。
使用场景：团队共享的 Swagger PDF、内部设计规范、第三方 SDK 手册，位置固定且不随项目迁移。
- Linux/macOS：执行
ln -s /path/to/docs ./docs - Windows（管理员 PowerShell）：
New-Item -ItemType SymbolicLink -Path ".\docs" -Target "C:\shared\docs" - 重启 VSCode 或刷新资源管理器（
Ctrl+R），docs/就会稳定出现在资源树顶部 - 点击即开，PDF 自动用
vscode-pdfviewer渲染，无需额外配置
PDF 文档缩放与滚动模式设为项目级默认
全局设置（settings.json）容易覆盖不同文档需求，比如代码参考 PDF 需要 page-width，而学术论文 PDF 更适合 page-fit。真正在意效率的人，会把配置下沉到具体项目。
性能影响：每次打开 PDF 时动态加载缩放策略，比全局硬编码慢约 80–120ms，但换来的是精准适配，避免手动调缩放。
- 在项目根目录创建
.vscode/settings.json - 写入：
{ "pdf-preview.default.scale": "page-width", "pdf-preview.default.scrollMode": "vertical", "pdf-preview.default.sidebar": false } - 该配置只对当前工作区生效，切换项目自动切换行为
- 注意：如果同时安装了多个 PDF 插件（如
pdfjs-extension），需禁用冲突插件，否则pdf-preview.*配置无效
搜索 PDF 内容时别依赖 Ctrl+F
Ctrl+F 在 PDF 预览页里默认触发浏览器原生查找，结果常漏字、不分页、无法跨页跳转。真正可用的是 vscode-pdfviewer 自带的搜索框（位于预览页右上角放大镜图标旁），它基于 PDF.js 引擎，支持正则、高亮全文档、定位页码。
容易踩的坑：点开 PDF 后习惯性按 Ctrl+F，发现搜不到“token”，其实是因为 PDF 字体嵌入方式导致文本层缺失——这时该换用插件搜索框，它会尝试 OCR 回退逻辑（需插件 v1.10.0+）。
- 确保插件版本 ≥ 1.10.0（检查扩展面板右下角更新提示）
- 搜索前先确认右上角有独立搜索输入框，没有则说明插件未激活或 PDF 损坏
- 复杂公式/扫描版 PDF 搜索失败时，可尝试导出为文本（右键 →
Copy Text Content），粘贴到新文件里再搜
