VSCode离线文档搜索需按格式区分：HTML/Markdown可用Ctrl+Shift+F全文搜（需排除设置），PDF需vscode-pdfviewer扩展后Ctrl+F搜索，CHM/EPUB不支持；Ctrl+P仅按文件名路径快速定位。
VSCode 本身不自带离线文档，所谓“离线文档”通常指你本地已下载的 HTML、PDF 或 Markdown 格式的技术文档（如 React 官方文档镜像、TypeScript 手册、TensorFlow API 参考等）。这类文件无法被 VSCode 的 Ctrl+Shift+F 直接索引全文——除非你把它当普通文本文件打开并手动搜索。真正能快速查内容的方式，取决于文档格式和你是否做了前置准备。
用 Ctrl+P 快速定位离线文档中的具体文件
如果你把离线文档解压成结构清晰的目录（比如 react-docs/ 下有 hundreds of .html 文件），Ctrl+P（macOS 是 Cmd+P）是最轻量、最可靠的入口：
- 按
Ctrl+P后直接输入文件名关键词，例如hooks、useEffect、api-reference，VSCode 会模糊匹配路径和文件名 - 支持路径分隔符搜索：输入
react/docs/hooks可快速定位到子目录 - 若文档含
.gitignore或被search.exclude排除，默认不会出现在Ctrl+P结果里；需在设置中关闭Search: Use Ignore Files - 注意：
Ctrl+P不搜索文件内部文本，只找文件名和路径
对 HTML / Markdown 离线文档启用 Ctrl+Shift+F 全文搜索
HTML 和 Markdown 文件本质是纯文本，Ctrl+Shift+F 能搜，但默认可能被过滤或效率低：
- 先确认文档目录没被
search.exclude拦截：打开搜索面板 → 点右上角⋯→ 取消勾选Use Exclude Settings and Ignore Files，或清空files to exclude输入框 - 在
files to include中填入明确范围，例如**/*.html、docs/**/*.{md,html}，避免扫描整个项目 - 别开
Match Case或Use Regular Expression，除非真需要；开了却输错正则（比如中文括号、未转义点号），会静默返回空结果 - 首次搜索大目录会卡顿 1–2 秒，右下角显示
搜索中…时别急着重输
PDF 离线文档必须装扩展才能查内容
VSCode 默认不解析 PDF 文本，双击打开只是渲染画面。要真正搜索内容，得靠 vscode-pdfviewer 这类扩展：
- 安装后，用
Ctrl+P打开 PDF 文件，再按Ctrl+F（不是Ctrl+Shift+F）即可在当前 PDF 内部搜索 - 该搜索是 PDF.js 引擎驱动的，支持中文、高亮、跳转，但不能跨多个 PDF 文件全局搜
- 如果 PDF 是扫描版（图片型），全文搜索失效——VSCode 无 OCR 能力，此时只能靠外部工具转文字
- 扩展配置项如
pdf-preview.default.scale影响阅读体验，但不影响搜索能力
真正容易被忽略的点是：离线文档的「可搜索性」不取决于 VSCode，而取决于它本身的格式和组织方式。HTML 好搜，PDF 需扩展，CHM 或 EPUB 则完全不支持。别指望 Ctrl+Shift+F 自动覆盖所有类型——先确认文档是不是纯文本，再决定用哪条路径。
