Zotero 全文搜索不了怎么办？
简答：Zotero 全文搜索不了，最常见的原因不是文献丢失，而是搜索入口用错、PDF 没有可提取文字，或全文索引没有建立。先在库顶部搜索框切换到 Everything；如果只搜索一个附件，可右键附件执行 Reindex Item；仍无结果，再到设置中的 Search 页面执行 Rebuild Index。扫描版 PDF 还需要先完成 OCR，并确认 OCR 后的文字可以复制。
定义：Zotero 全文搜索是基于附件文字索引的检索功能，主要覆盖 PDF、EPUB、HTML 和纯文本文件，不等同于 PDF 阅读器内的页面查找。
先判断：你是在什么地方搜索？
本文为第三方技术排查指南，不代表 Zotero 官方页面。先不要重装软件，也不要直接删除数据库。Zotero 至少有三种容易混淆的搜索方式：PDF 阅读器内查找、库顶部 Quick Search，以及 Advanced Search。三者的搜索范围不同，排查顺序也不同。
| 现象 | 实际使用的入口 | 先做什么 | 成功标准 |
|---|---|---|---|
| 打开某个 PDF 后，页面内找不到词 | PDF 阅读器内查找 | 先确认 PDF 是否能选中并复制文字 | 能在当前文件页面内定位关键词 |
| 库顶部搜索框搜不到附件内容 | Quick Search | 把搜索模式切换为 Everything | 能从多个附件返回包含关键词的条目 |
| 需要按附件内容、作者或其他条件组合筛选 | Advanced Search | 添加 Attachment Content 条件 | 搜索结果符合条件，而不是只匹配标题或作者 |
| 所有 PDF 都搜不到，或结果明显不完整 | 全文索引 | 查看索引状态，先单文件重建，再整体重建 | 索引统计中的未索引或部分索引文件减少 |
官方说明显示，Zotero 会为附件建立全文索引，Quick Search 使用 Everything 模式，Advanced Search 则使用 Attachment Content 条件。可参考 Zotero Search 设置说明。
最快修复顺序：从低风险到高成本
- 先换搜索模式：在 Zotero 库顶部搜索框中输入关键词，并确认模式不是 Title、Creator 或其他仅匹配元数据的选项，而是 Everything。搜索一个确定出现在 PDF 正文中的普通词，不要一开始使用过长句子。
- 再试 Advanced Search：打开高级搜索，添加 Attachment Content 条件，输入同一个关键词。若这里能搜到，说明文件内容存在，问题可能只是 Quick Search 的模式或当前筛选范围不合适。
- 只针对一个附件重建索引：在条目列表中找到 PDF、EPUB 或 HTML 附件，右键选择 Reindex Item。等待索引完成后，再搜索一个确认存在于正文中的词。
- 检查全文索引设置：打开 Windows/Linux 的 Edit → Settings，或 macOS 的 Zotero → Settings，进入 Search 页面，查看索引统计和全文索引字符上限。官方文档说明，将上限设为 0 会禁用全文索引；超长文件也可能只被部分索引。
- 最后整体重建：在 Search 设置中选择 Rebuild Index。这是针对整个库的操作，可能需要等待。开始前先确认 Zotero 数据已同步或已有独立备份，不要在重建过程中强制结束程序。
上述入口和设置名称以 Zotero 当前界面为准；若你的界面布局不同，应优先在设置页搜索 Search、Full-Text Cache 或全文索引，而不要直接复制不确定的配置文件路径。
如果 PDF 内 Ctrl-F 也搜不到：先检查文字层
如果你打开 PDF 后，在阅读器内查找也没有结果，先不要把问题归因于 Zotero 索引。尝试用鼠标选中一段正文并复制到纯文本编辑器：
- 能够选中连续、可读的文字：PDF 通常具备文字层，继续检查 Reindex Item 或 Rebuild Index。
- 只能选中整页图片，或完全无法选中文字：这通常是扫描版或图片型 PDF，需要先进行 OCR。
- 能够复制，但复制内容是乱码、空白或字符顺序明显错误：先检查原文件质量，必要时重新获取可检索版本，再重新索引。
Zotero 官方说明，PDF 全文检索依赖从 PDF 中提取文字的工具；因此“文件能打开”不等于“文件一定可被全文索引”。可参考 Zotero PDF 全文索引说明。
完成 OCR 后，重新把文件放回 Zotero，确认可以复制文字，再对该附件执行 Reindex Item。OCR 只是把图片中的文字转换成文本，不能保证识别结果完全正确；专有名词、公式、表格和双栏排版尤其需要抽样检查。
附件类型、关联方式和搜索范围也会影响结果
Zotero 官方 Search 文档列出的可全文索引类型包括 PDF、EPUB、HTML 和纯文本文件。DOCX、ODT 等其他文档类型不能直接依靠 Zotero 的同一套全文索引功能进行搜索，因此不要把“附件已添加”误认为“附件内容一定可检索”。
如果 PDF 是单独拖进库的文件，还要检查它是否只是独立附件，或是否已经正确挂到对应的父条目下。独立附件仍可能被打开，但很多基于条目的搜索和管理功能会受到影响。可参考 Zotero 添加文件与附件关联说明。
- 只搜某个集合时，先确认目标 PDF 确实位于当前集合或当前视图范围内。
- 如果是链接文件，确认原始路径仍然存在，并能从 Zotero 打开；更换电脑或移动文件后，链接可能失效。
- 如果只有新导入的文件搜不到，而旧文件正常，优先对新文件执行 Reindex Item，不要立即整体重建。
- 如果只有超长文件结果不完整，检查全文索引字符数上限，并用文件前段、中段、后段各选一个词测试。
按症状定位：不要把不同问题混在一起
| 症状 | 较可能的范围 | 验证动作 | 低风险回退 |
|---|---|---|---|
| 只有一个 PDF 无结果 | 文件文字层、附件索引或文件损坏 | 复制文字，再执行 Reindex Item | 保留原文件，重新导入一份副本测试 |
| 所有附件无结果 | 搜索模式、索引设置或索引数据库 | 用 Everything 搜索，再看 Search 页面统计 | 先只重建一个附件，确认后再 Rebuild Index |
| PDF 内查找有效，库内搜索无结果 | Zotero 全文索引未更新或搜索入口不对 | 切换 Everything，执行 Reindex Item | 暂时使用 PDF 阅读器内查找，避免改动数据文件 |
| 库内能搜到，PDF 内 Ctrl-F 无结果 | 阅读器当前页面、文本层或阅读器状态 | 复制正文并在外部纯文本编辑器测试 | 重新打开附件，必要时用系统默认 PDF 阅读器核对 |
| 只能搜到文件前半部分 | 全文索引字符数上限 | 用文件后半段的独特词测试 | 调整上限后重新索引，先记录原设置 |
任何需要移动、删除或复制 Zotero 数据目录文件的操作，都应先关闭 Zotero 并完成备份。官方数据目录说明指出，全文索引文件可以重新生成，但数据库和附件文件不能当作普通缓存随意删除。可参考 Zotero 数据目录与备份说明。
建议的最终排查清单
- 确认你要解决的是 PDF 内查找，还是 Zotero 库内全文搜索。
- 在库顶部把搜索模式切换为 Everything；组合检索时使用 Attachment Content。
- 确认附件是 PDF、EPUB、HTML 或纯文本，而不是仅支持元数据管理的其他文档类型。
- 复制 PDF 中一段正文，判断是否存在可检索文字层。
- 单个文件无结果时执行 Reindex Item。
- 多个文件或全部文件无结果时，检查 Search 设置、索引统计和字符数上限。
- 确认备份或同步状态正常后，再执行 Rebuild Index。
- OCR 后重新索引，并用正文中明确存在的词验证，而不是只测试标题、作者或引用格式。
如果完成上述步骤后仍然无结果，记录操作系统、Zotero 界面中的搜索模式、附件类型、是否能复制文字、索引统计，以及一个可复现的关键词。这样比直接重装软件更容易判断问题究竟发生在文件、索引还是搜索范围。
常见问题
Zotero 顶部搜索框为什么搜不到 PDF 里的文字？
先确认搜索框模式为 Everything，而不是只搜索标题、作者或标签。然后用明确出现在 PDF 正文中的单个词测试；仍无结果时，对该附件执行 Reindex Item。
PDF 阅读器里 Ctrl-F 搜不到，是否说明 Zotero 索引坏了？
不一定。先尝试复制 PDF 正文。如果只能选中图片或无法复制文字，文件可能是扫描版，需要 OCR；如果能复制文字，再继续检查阅读器状态和全文索引。
Zotero Advanced Search 怎样搜索 PDF 正文？
在 Advanced Search 中添加 Attachment Content 条件，并输入正文中确定存在的关键词。不要只使用 Title、Creator 或 Publication 条件，否则搜索范围可能只覆盖文献元数据。
Reindex Item 和 Rebuild Index 有什么区别？
Reindex Item 只处理选中的附件，适合单个 PDF 出问题；Rebuild Index 会重新建立整个库的全文索引，适合多个附件或整体搜索异常，但操作范围更大，开始前应确认数据可恢复。
DOCX 或 ODT 放进 Zotero 后，为什么不能像 PDF 一样全文搜索？
Zotero 官方 Search 文档列出的全文索引类型主要包括 PDF、EPUB、HTML 和纯文本文件，DOCX、ODT 等类型不能直接依靠同一套全文索引功能搜索。可以把需要检索的内容转换为可复制文本的 PDF，或使用适合该文档类型的系统搜索工具。
重建索引会删除我的 PDF 或文献吗？
重建全文索引的目标是重新生成搜索索引，不是删除附件。但仍建议在执行整体重建前确认同步或备份状态，不要手动删除 Zotero 数据目录中的数据库和附件文件。