清除神秘的引用标记
拼写错误、缺少编译轮次、路径错误、BibTeX 与 Biber 不匹配。
清除神秘的引用标记
症状
文档能编译,但在应出现引用的位置,你看到的是一个加粗的问号 [?],日志里则有 LaTeX Warning: Citation 'knuth84' undefined 这样的行。有时所有引用都中招,有时只有一两个。因为这是警告而不是错误,PDF 照样生成,这些问号也就很容易被漏掉,直到有读者指出来。
原因
LaTeX 并不直接解析引用。第一轮编译时,它把每个请求的引用键记录到辅助文件里;随后一个后端程序(bibtex 或 biber)到你的 .bib 数据库中查这些键,并写出格式化条目;再经两轮 LaTeX 编译把结果写回文档。问号的意思是:最后一轮编译时,该键还没有任何格式化条目。这个症状的每一种成因,都是这条流水线在某处断了。
按顺序排查原因
先检查键本身。\cite{knuth84} 和 @article{knuth1984,...} 是不同的字符串,匹配是精确匹配,区分大小写。在 .bib 文件里搜索警告中提到的键;任何一边的拼写错误都是最常见的原因,而日志里第一条缺失键的警告就是该追查的那条。
接下来,确认跑完了整个编译周期。顺序是 LaTeX,然后 bibtex 或 biber,然后再来两轮 LaTeX。只编译一次永远无法解析引用,因为后端还没运行。Oleafly 会管理这些编译轮次;当参考文献需要 Biber 时,请使用 TinyTeX 或系统 TeX 引擎。但手动构建或配置不当的编辑器可能在第一轮后就停下了。
第三,核对数据库路径。\bibliography{refs} 和 \addbibresource{refs.bib} 都相对主文件解析,所以子文件夹里的数据库必须写成 bib/refs 或 bib/refs.bib。路径错误会无声无息地失败,而且通常会连累整个参考文献列表;那一类更大的故障见参考文献列表为空。
最后,让后端与体系匹配。加载了 biblatex 的文档必须用 biber 处理。喂给它经典 bibtex 不会得到可用的输出,无论重新编译多少次,每个引用都仍是问号。
如果以上都无效
陈旧的辅助文件可能留着旧的损坏状态。删掉文档旁的 .aux、.bbl 和 .blg 文件,从头重建。删除之前,.blg 文件值得一读:它是后端自己的日志,会明确点名缺失的数据库和格式错误的条目。