参考文献为空
路径、后端、缺失的引用,以及 printbibliography 与 bibliography 的区别。
参考文献为空
症状
你的文档编译时没有致命错误,但“参考文献”部分完全不见了,或者标题出现了却什么内容都没有。通常正文里的每个 \cite 同时也显示为粗体问号。什么都没有崩溃,所以没有明显的错误可追查,这正是它令人沮丧的原因。
为什么会这样
参考文献不是单靠 LaTeX 生成的。LaTeX 先把被引用的键的列表写入一个辅助文件。一个独立的后端程序(bibtex 或 biber)读取你的 .bib 数据库,并格式化匹配的条目。最后 LaTeX 在下一轮把格式化好的结果读回来。参考文献为空,意味着这条流水线在某处断了:后端根本没有运行;运行了却找不到数据库;找到了数据库却没有请求任何键;或者文档用错了命令来索取结果。
按顺序逐项排查
第一,确认数据库文件确实在文档所指的位置。\bibliography{refs} 和 \addbibresource{refs.bib} 都是相对于主文件去找 refs.bib,所以放在 bib/ 子文件夹里的文件必须写成 bib/refs 或 bib/refs.bib。路径错误会悄无声息地失败。
第二,确保后端确实运行了。只编译一次永远不够;完整的流程是先运行 LaTeX,然后运行 bibtex 或 biber,再运行两次 LaTeX。Oleafly 会替你管理编译轮次;Biber 项目请选择 TinyTeX 或系统 TeX 引擎。但手动驱动的构建,或配置有误的编辑器工具链,可能会跳过中间那一步,结果正是一个空的参考文献列表。
第三,检查文档中至少有一个 \cite 命令。后端只会格式化文档所请求的条目,所以一份还没有任何引用的草稿,列表为空是设计使然。在早期起草阶段,你可以用 \nocite{*} 强制把所有条目纳入,它会请求数据库中的每个条目,而不会在正文里打印任何东西。
第四,让命令与系统匹配。经典的 BibTeX 文档以 \bibliographystyle{...} 和 \bibliography{refs} 结尾。biblatex 文档在导言区用 \addbibresource{refs.bib} 加载数据库,并用 \printbibliography 打印它。把两者混用,例如加载了 biblatex 却仍调用 \bibliography,正好会导致这种失败。运行错误的后端也是如此:biblatex 需要 biber,把它交给经典的 bibtex 什么也得不到。
阅读后端自己的日志
后端会把它的抱怨写入文档旁边的 .blg 文件,格式错误的条目、重复的键,以及“I couldn’t open database file”之类的消息都会出现在那里。如果上面的步骤看起来都没问题,列表却仍然为空,.blg 日志几乎总能点出真正的罪魁祸首。如果参考文献本身出现之后问号依然存在,见清除引用处的神秘标记。