更新R 4.0.4与RStudio 1.4.1106后bookdown knitting参考文献异常求助

核心原因定位 #

你遇到的两类问题（分节参考文献不显示、条目间距丢失），均对应bookdown 0.22版本对默认参数的调整，和R、RStudio本身的版本更新无直接关联，是R更新时连带自动升级的bookdown包修改了默认配置导致。整个配置流程不存在语法错误，因此渲染过程不会抛出任何报错信息，仅输出效果与旧版本不一致。 #

分节显示参考文献失效修复 #

• 不要依赖RStudio全局配置项的设置，该配置仅影响单文件R Markdown渲染，不会作用于bookdown书籍输出，必须在项目专属配置中显式开启对应参数：
  • 打开项目根目录下的_output.yml文件，对应你使用的输出格式（如bookdown::gitbook、bookdown::pdf_book），添加split_bib: true参数。该参数是控制「每节末尾显示对应参考文献」的核心开关，0.22版本之后该参数默认值从TRUE改为了FALSE，因此原有不显式写参数的旧配置会直接失效。
  • 配置示例片段：

    bookdown::gitbook:
      split_bib: true
      # 其余原有配置保留即可
    

参考文献条目间距丢失修复 #

• HTML类输出（如gitbook、bs4_book）：在项目自定义CSS文件（通常为根目录下的style.css）中添加如下样式，强制恢复条目间的空行间距：

  /* 参考文献条目间距设置 */
  div.csl-entry, .citation-item {
    margin-bottom: 1em;
  }
  

• PDF类输出：在_output.yml的pdf_book配置块中，通过引用包参数指定条目间距：

  bookdown::pdf_book:
    citation_package: natbib
    natbib_options: "bibsep=0.8em"
  

可选兼容方案 #

如果不想调整现有配置，可直接回退到版本变更前的bookdown稳定版，执行如下R代码安装指定版本：
remotes::install_version("bookdown", version = "0.21")

注意：后续重新渲染时不要触发bookdown的包自动更新，即可回到升级前的正常状态。

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