ZotLit
常见问答

Obsidian Zotero Integration 无法运行:排查要点

当 Obsidian Zotero Integration 停止工作时的排查步骤,以及 ZotLit 如何处理连接、模板和 Zotero 9 或 10。

Zotero Integration 需要 Zotero 保持运行并安装 Better BibTeX 插件,请对照下表排查出现的提示信息。"No citation found" 来自另一个插件 Pandoc Reference List,而不是 Zotero Integration。

ZotLit 的开发者并不维护 Zotero Integration。本页内容仅汇总了 Zotero Integration 自身 README、文档、源代码和问题追踪器中给出的排查建议,核对时间为 2026 年 11 月 11 日。

出现的提示排查要点依据来源
"Cannot connect to Zotero. Please ensure it is running and the Better BibTeX plugin is installed"Zotero 已打开,且 Better BibTeX 插件已在 Zotero 中安装并启用。Zotero Integration 源代码和 README
"Import failed for" 及笔记路径,"check developer console for details"打开 Obsidian 的开发者控制台查看错误详情。检查模板中是否存在拼写错误。检查所选的参考文献样式是否已在 Zotero 中安装。运行 Data explorer 命令查看 Zotero 发送的数据。其源代码及常见问题解答
插入引文或参考文献列表时报错Zotero 中已选择“快速复制”(Quick Copy)样式,且在 Zotero 中选中条目后可以通过编辑(Edit)菜单复制引文。其 README
插件无法加载Obsidian 安装包版本为 0.13.24 或更高。其 README
"Unexpected end of JSON input"更新 Zotero Integration。2024 年 1 月的三次 Better BibTeX 更新曾导致此问题;维护者已于 2024 年 1 月 4 日发布修复版本。其问题追踪器中的 Issue #329,维护者回复
"No citation found for" 及文献引用标识此提示来自 Pandoc Reference List 插件。其 README 要求使用 Pandoc 2.11 或更高版本并配置参考文献文件路径。Pandoc Reference List 源代码和 README

用户反馈:选择文献后“没有任何反应”

以下步骤整理自 2026 年 Zotero Integration 问题追踪器中的用户反馈,而非维护者的官方建议。用户反映打开选择器后未创建任何笔记。其他用户验证有效的两种解决方法:

  • 条目的 Citation Key 为空:在 Zotero 中选中相应条目,右键点击,打开 Better BibTeX,重新生成文献引用标识(Issue #469)。
  • Zotero 更新后失效:在 Zotero 中更新 Better BibTeX 并重启 Zotero(Issue #463 与 #481)。

Zotero 8、9 和 10

Zotero Integration 的 README 和文档未注明适用的 Zotero 版本。其最后一个版本是 2024 年 8 月 11 日发布的 3.2.1。其代码仓库目前由 Obsidian Community Archive 托管,该归档库定位为“原作者已无法继续维护的热门社区插件与主题的存放空间”。

在 ZotLit 中完成同样的工作

  • 连接 Zotero:ZotLit 直接读取 Zotero 数据库。连接不依赖 Better BibTeX,浏览、搜索和阅读时无需打开 Zotero。
  • 导入高亮:高亮和评论保存在文献笔记的特定托管区域内。更新时仅会重写该部分;托管区域之外自行撰写的内容原样保留。
  • 插入引用:在笔记中输入 [@ 即可选择文献。
  • 模板系统:ZotLit 使用 Liquid;Zotero Integration 使用 Nunjucks。迁移指南中提供了两者语法的对应表。
  • 现有笔记:全部为标准的 Markdown 文件,完整保存在你的仓库中。

迁移前,确认你的 Zotero 版本

  • ZotLit 支持读取 Zotero 9 和 Zotero 10。
  • 可选安装的 ZotLit Companion 插件支持 Zotero 9 和 10。
  • 在 Obsidian 中编辑高亮需要使用 Zotero 10。
  • ZotLit 需要 Obsidian 1.15.1 或更高版本,且安装包版本不低于 1.13.4。
  • 若使用的是 Zotero 8 或更早版本,请在安装 ZotLit 前先升级 Zotero。

常见问题

为什么 Obsidian 提示 "No citation found"?

该提示来自 Pandoc Reference List 插件,它会为笔记中的每个文献引用标识显示对应的参考文献。其 README 要求使用 Pandoc 2.11 或更高版本并配置参考文献文件路径,请在其设置中检查这两项。

Zotero Integration 支持 Zotero 9 或 10 吗?

其 README 和文档未说明支持哪些 Zotero 版本,其最新版本为 2024 年 8 月 11 日发布的 3.2.1。在其问题追踪器中,部分用户反馈在更新 Better BibTeX 并重启 Zotero 后可以在 Zotero 9 上使用。另有用户报告在 Zotero 9.0.4 和 Zotero 10 测试版上无任何错误提示直接失效。

迁移到 ZotLit 会改动我现有的笔记吗?

不会。你的 Zotero Integration 笔记是纯 Markdown 文件,会原样保留在仓库中。笔记中的 %% begin notes %% 标记会作为注释保留,ZotLit 会忽略它们。

使用 ZotLit 需要 Better BibTeX 吗?

如果只是浏览文库、阅读 PDF 或撰写文献笔记,不需要。若要在写作时插入引用,则需要:ZotLit 通过 Zotero 自身的文献引用标识(Citation Key)字段来引用文献,而 Better BibTeX 正是为每篇文献生成该标识的 Zotero 插件。

下一步

准备迁移时,请参阅从 Zotero Integration 迁移的分步指南,了解如何从 Pandoc Reference List 迁移,或从 将 Zotero 连接到 Obsidian:你的第一篇文献笔记 (约 12 分钟) 开始学习。

最后更新于

本页目录