升级Debian Buster后Citeproc报bibtex-completion-display-formats空变量错误

• Org模式下使用org-cite-insert插入文献引用功能完全正常
• 执行Org文档导出HTML操作时触发Lisp报错，故障出现于Chromebook执行powerwash（恢复出厂设置）重装Debian Buster系统之后
  触发的完整错误日志如下：

Debugger entered--Lisp error: (void-variable bibtex-completion-display-formats)
  byte-code("\306 \210\307\10\310\11!\n#\210\311\303\312\313\314DD\315\316\317\320\321&\7\210\322\13G\13\323\3\3X\203G\0\1:\203G\0\1@\262\1\324\1@\f..." [org-mode-map org-ref-insert-cite-key org-ref-insert-link-function org-ref-bibtex-completion-actions helm-source-bibtex bibtex-completion-format-citation-functions org-ref-bibtex-completion-completion define-key kbd custom-declare-variable funcall function #f(compiled-function () #<bytecode 0x1f400016fe914>) "Cons cells of string and function to set the actio..." :type (alist :key-type (string) :value-type (function)) :group org-ref 0 nil helm-delete-action-from-source helm-add-action-to-source org-ref-bibtex-completion-format-org #f(compiled-function () #<bytecode 0x1f4010b9da114>) "Function for how `helm-bibtex' inserts citations." org-mode org-ref-helm-insert-cite-link org-ref-cite-click-helm org-ref-bibtex-completion-add-keywords-field #f(compiled-function () #<bytecode 0x1f400016fe5d4>) "Whether to add the `keywords' field to bibtex-comp..." boolean keywords "keywords" alist-get t "{keywords:" string-match " ${keywords:31}" org-ref-insert-cite-function org-ref-cite-onclick-function bibtex-completion-additional-search-fields bibtex-completion-display-formats inhibit-changing-match-data] 8)
  require(org-ref-helm-bibtex)
  eval-buffer(#<buffer  *load*-422164> nil "/home/pixel/.emacs.d/elpa/org-ref-2.0.0/org-r..." nil t)  ; Reading at buffer position 1644
  load-with-code-conversion("/home/pixel/.emacs.d/elpa/org-ref-2.0.0/org-r..." "/home/pixel/.emacs.d/elpa/org-ref-2.0.0/org-r..." nil t)
  require(org-ref)
  eval-buffer(#<buffer  *load*> nil "/home/pixel/.emacs.d/elpa/citeproc-org-0.2.4/..." nil t)  ; Reading at buffer position 1539
  load-with-code-conversion("/home/pixel/.emacs.d/elpa/citeproc-org-0.2.4/..." "/home/arcotpixel/.emacs.d/elpa/citeproc-org-0.2.4/..." nil t)
  citeproc-org-render-references(html)
  run-hook-with-args(citeproc-org-render-references html)
  org-export-as(html nil nil nil (:output-file "article.html"))
  org-export-to-file(html "article.html" nil nil nil nil nil)
  org-html-export-to-html(nil nil nil nil)
  org-export-dispatch(nil)
  funcall-interactively(org-export-dispatch nil)
  call-interactively(org-export-dispatch nil nil)
  command-execute(org-export-dispatch)

报错核心为void-variable bibtex-completion-display-formats，即bibtex-completion-display-formats变量未定义。触发链路为：导出HTML时citeproc-org自动加载org-ref，你安装的org-ref 2.0.0版本依赖bibtex-completion（helm-bibtex/ivy-bibtex的底层依赖库）中的该变量，但重装系统后从ELPA源拉取的bibtex-completion为2023年后发布的新版本，新版本已移除该变量，最终触发未定义变量错误。

• 版本校验：执行M-x list-packages查看已安装包版本，若org-ref为2.0.0版本、bibtex-completion为2023年后发布的新版本，即可确认是版本不匹配问题。
• 临时快速修复：在Emacs配置文件（通常为~/.emacs或~/.emacs.d/init.el）中，在加载org-ref相关配置前添加如下兼容代码，补全缺失的变量定义：

;; 兼容新旧版本bibtex-completion与org-ref
(defvar bibtex-completion-display-formats
  '((t . "${=has-pdf=:1}${=has-note=:1} ${year:4} ${author:36} ${title:*} ${=type=:3}"))
  "Display formats for bibtex completion entries.")

保存配置后重启Emacs即可验证导出功能。

• 长期方案1：升级org-ref至最新Git版本，新版已完成对新版bibtex-completion的适配，无需手动添加兼容代码。
• 长期方案2：若不希望升级org-ref，可将bibtex-completion、helm-bibtex回退至2022年及之前发布的版本（如bibtex-completion 2.0.0），与org-ref 2.0.0的依赖完全匹配。

内容的提问来源于stack exchange，提问作者extrav