为何收录

写 LaTeX 或 Markdown 论文时,引用键是正文和文献库之间唯一的连接。Zotero 自带的 BibTeX 导出在每次导出时临时生成引用键,带来三个问题:导出前看不到键;改正作者拼写或标题后键会变;键冲突时哪一条加后缀并不确定。BBT 把引用键变成条目上可见、可自定的数据,并让 .bib 文件随文献库自动更新,适合写作周期长、文献反复增删的学位论文作者、合著团队,以及用 Overleaf 或 Pandoc 排版的研究者。它还能在导入导出时互转 Unicode 字符与 LaTeX 写法(如 ö 与 "{o}),减少 BibTeX 编译时的字符问题。

引用键规则

BBT 的默认公式是 auth.lower + shorttitle(3,3) + year:取第一作者姓氏并转为小写,接标题前三个词(这三个词首字母大写),再接出版年;如果与库中已有的键冲突,自动追加 a、b、c 等字母后缀。这个后缀不能关闭,但可以改成 Zotero 式的数字。举例来说,第一作者为 Smith、标题为 Protein Structure Prediction Methods 的 2021 年论文,按公式推算会得到类似 smithProteinStructurePrediction2021 的键(按文档规则推算,未经软件生成)。

公式由四类元素组成:函数(如 auth、shorttitle,以小写字母开头)、字段读取(以大写字母开头,直接取 Zotero 字段)、过滤器(如 .lower,可以链式叠加)和引号中的固定文字,并可用 +、||、&& 和三元运算组合。多条公式用分号或竖线分隔,按顺序取第一个非空结果,全部为空时生成随机键。有两点要注意:一是修改公式只影响之后新建或修改的条目,已有的键不会自动重算,需要选中条目、右键执行 Better BibTeX > Refresh;二是 Zotero 8 之后引用键存进 Zotero 原生字段,官方说明“键现在总是固定的”,并且可以随 Zotero 同步,用户也可以手动改成自己想要的键。

引用键还能直接拖进编辑器。这需要一次性设置:在 BBT 偏好设置的 Citation keys 中选定 Quick Copy 格式,再到 Zotero 设置的“导出”页,把默认输出格式设为“Better BibTeX Quick Copy: 所选格式”。之后把条目拖进 LaTeX、Markdown 或 Org-mode 编辑器,就会插入 \cite{citekey}、[@citekey] 或带 zotero://select 链接的引用;LaTeX 的引用命令名可在偏好设置里修改,填写时不带反斜杠。

自动导出设置

自动导出只能在一次导出操作中注册,不能在偏好设置里新建:

  1. 在 Zotero 左侧栏右键文献库、群组或分类,选择“导出文库…”或“导出分类…”。
  2. 格式选择 BBT 提供的转换器(如 Better BibTeX 或 Better BibLaTeX),勾选 Keep updated(保持更新)。
  3. 选择保存位置,例如论文项目目录下的 references.bib。此后该分类或文库中的条目一有变动,就会触发重新导出。

执行时机在 BBT 偏好设置中选择:on change 尽快执行;on idle 等 Zotero 空闲几秒后执行;paused 暂停执行,但仍记录待导出的任务。已注册的任务在偏好设置的 Automatic exports 标签页查看、修改或删除。作者提醒不要设置过多自动导出,按论文分别建分类、只导出需要的部分,性能更好。

Overleaf 在线 LaTeX 编辑器界面:左侧为项目文件与源代码,右侧为编译后的 PDF 预览

Overleaf 在线 LaTeX 编辑器界面。BBT 自动导出的 .bib 文件可以通过云盘直链或 git 同步到这类项目中。图片:Overleaf, Microsoft,来源 Wikimedia Commons,许可 CC BY-SA 4.0。

要把 .bib 同步到 Overleaf,官方文档列了三种做法:导出到能提供直接下载链接的云盘文件夹,再在 Overleaf 用 Add file > From external URL 导入,新增文献后在 Overleaf 手动刷新;使用 Overleaf 的 Dropbox 集成(Overleaf 付费功能);或者在论文仓库的克隆中运行 git config zotero.betterbibtex.push true 并把自动导出指向该目录,BBT 每次导出都会依次执行 git pull、导出、add、commit 和 push(Overleaf 的 git 集成同样是付费功能)。git 方式会把该克隆里其他已暂存的改动一并提交推送,作者建议单独准备一个只供 BBT 写入的克隆。

想先确认它是否适合自己的流程,可以做一个小规模验收(这是建议,本文未执行):建一个含 5 条文献的测试分类,以 Better BibLaTeX 格式勾选 Keep updated 导出到空目录;修改其中一条的标题,看 .bib 是否自动更新而引用键保持不变;再加入一篇与已有条目同作者、同年份、标题开头相近的文献,看是否得到带字母后缀的不重复键。

参考文献

  1. Emiliano Heyns. retorquere/zotero-better-bibtex. GitHub,2026-10-18 核验。

  2. Release v9.0.71. GitHub,2026-10-07 发布。

  3. LICENSE(MIT License). GitHub。

  4. package.json(master 分支,version 9.0.71). GitHub,2026-10-18 核验。

  5. Better BibTeX for Zotero 官方文档.

  6. Installation. Better BibTeX for Zotero 文档。

  7. Citation Keys. Better BibTeX for Zotero 文档。

  8. Automatic export. Better BibTeX for Zotero 文档。

  9. Zotero Version History. Zotero 文档,2026-10-18 核验。

  10. Issue #3626: CAYW endpoint returns empty response on Zotero 10.0.6 / BBT 9.0.71. GitHub,2026-10-08 提交。

  11. 信息由 Scholay 学术一站式平台 整理并发表,如有侵权请反馈下架。

  12. 信息同步发表于恩特学术,智能时代的学者社区