使用Bookdown导出Word时，章节参考文献文内引用渲染异常求助

一、文件准备与命名规则 #

• 保持Bookdown常规文档结构：以index.Rmd作为入口文件，各章节文件命名为chapter1.Rmd、chapter2.Rmd等，所有Rmd文件存放在工作根目录。
• 为每个章节单独创建参考文献文件，命名与章节文件严格对应，比如chapter1.bib、chapter2.bib，直接放在工作根目录。禁止给.bib文件添加--1、--2这类后缀，此前的异常问题根源就在于此。
• 确保已安装pandoc-section-bibliographies工具：如果是npm环境，执行npm install -g pandoc-section-bibliographies；若用其他包管理工具，按对应方式安装即可，保证pandoc能调用该filter。

二、YAML头部配置 #

入口文件（index.Rmd）的YAML #

---
title: "你的文档标题"
author: "你的名字"
output:
  bookdown::word_document2:
    pandoc_args:
      - --filter
      - pandoc-section-bibliographies
section-bibliographies: true
link-citations: true
# 可选：如果有全局通用参考文献，添加下面一行
# bibliography: "global_references.bib"
---

各章节文件的YAML #

每个章节的Rmd文件开头，添加局部参考文献配置，以chapter1.Rmd为例：

---
bibliography: chapter1.bib
---

三、章节内引用写法 #

章节内的文献引用直接使用标准格式@citekey，无需添加任何章节后缀，比如：

这是一段引用示例@smith2020，展示了章节内的正常引用方式。

四、渲染与验证 #

• 渲染方式：直接在RStudio中点击「Knit」按钮，或在R控制台执行命令：

bookdown::render_book("index.Rmd", output_format = "bookdown::word_document2")

• 验证结果：导出的Word文档中，每个章节末尾会自动生成独立的参考文献列表，文内引用编号会按章节独立排序，不会出现引用找不到或文献合并的问题。

常见问题排查 #

• 若提示filter找不到，检查pandoc-section-bibliographies是否正确安装，可在终端执行pandoc-section-bibliographies --version确认。
• 若文献仍合并，检查章节Rmd文件的YAML是否正确指定了对应的.bib文件，确保文件名完全匹配。
• 若出现引用标识异常，检查是否手动修改过.bib文件里的citekey，保持原始citekey即可，filter会自动处理章节区分。

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