vscode离线文档搜索本质是本地文件检索，需将文档放入工作区并配置search.include/exclude规则，排除无关目录，注意中英文搜索设置及正则匹配细节。
VSCode 本身不带离线文档，所谓“离线文档搜索”实际是本地文件检索
VSCode 没有内置的离线 API 文档库（比如 Python 官方文档或 MDN 的离线版），它默认的「搜索」功能只是对工作区里已有的文本文件做全文匹配。如果你希望在本地文档（如下载好的 HTML 文档集、Markdown 笔记、PDF 转文本后的文件等）中快速查找内容，本质是配置 search.include 和 search.exclude，让搜索范围精准落到这些文档目录上。
把文档放对位置，并用 search.include 显式指定
很多人把文档解压到桌面或随意路径，结果搜不到——VSCode 默认只搜当前打开的工作区（${workspaceFolder}）。必须让文档成为工作区的一部分，或通过路径白名单引入。
- 推荐做法：新建一个文件夹（如
D:\docs\python-3.12-docs-html），把离线文档整个放进去 - 用 VSCode 打开这个文件夹（不是父目录，也不是单个 HTML 文件）
- 在该文件夹下创建
.vscode/settings.json，写入：
{
"search.include": {
"**/*.html": true,
"**/*.md": true,
"**/index.html": true
},
"search.exclude": {
"**/_sources/**": true,
"**/build/**": true,
"**/.*": true
}
}
这样搜索时就不会漏掉 HTML 文件，也不会误扫构建残留或隐藏目录。
search.exclude 会静默跳过文件，搜不到第一反应该查它
离线文档包常含大量 _static/、_modules/、.buildinfo 等非正文文件，VSCode 默认的 search.exclude 可能已经把这些路径全拦住了。你输关键词没结果，大概率不是引擎问题，而是目标文件根本没被纳入扫描。
- 打开搜索面板右上角
⋯→ “配置排除的文件” → 查看输入框里有没有类似**/_static/**的条目 - 临时验证：清空该输入框，再搜一个确定存在的词（如页面里的
def __init__） - 若此时能搜到，说明原排除规则太宽；可改用更精确的模式，例如只排除
**/_static/**，但保留**/_static/*.js（如果需要查 JS 示例）
中文文档搜索要关掉「Match Whole Word」，正则慎用点号
HTML 离线文档里中文段落密集，且常混排英文标识符（如 os.path.join）。直接开「Match Whole Word」会导致“路径”“join”这类词搜不到；而正则里的 . 默认匹配任意字符（包括换行），容易跨标签误匹配。
- 搜索中文关键词时，确保搜索面板左上角没有勾选
ab（Match Whole Word）图标 - 想精确匹配 HTML 标签内的文本？正则写成
<p>[^</p>，而不是<p>.*关键词.*</p> - 点号
.、星号*、问号?在正则模式下有特殊含义，纯文本搜索请先关闭.*图标
真正麻烦的不是配置本身，而是文档结构不统一——Sphinx 生成的 HTML、自制 Markdown 转的静态站、甚至 PDF 提取的纯文本，它们的标题层级、class 命名、段落包裹方式全都不一样。搜之前先手动打开一两个文件，确认你想找的内容在源码里实际长什么样，比盲目调参数有用得多。
