为何bookdown仅第3章节图片无法编号，其余章节正常？

针对你遇到的仅单个章节图片编号失效的情况，可按以下步骤排查修复：

• 核对图片标签与引用的一致性
  确认该章节所有图片的标签格式统一为bookdown要求的![图片标题](图片路径){#fig-自定义名称}，引用时使用@fig-自定义名称。重点检查是否存在标签拼写错误、重复使用同一标签的情况，这会直接导致编号逻辑混乱。

• 检查代码块生成图片的参数配置
  如果图片由R代码块生成（如ggplot绘图），确保代码块的命名与图片标签匹配，例如：

  {r fig-missing-dist, fig.cap="缺失值分布统计"}
  ggplot(...) # 绘图代码
  

  确认fig.cap参数不为空，且代码块未设置会干扰图片生成的异常参数（如eval=FALSE导致代码未执行）。

• 清理缓存后重新编译
  bookdown的缓存可能残留旧的编号信息，执行以下命令清理缓存：

  bookdown::clean_book(clean = TRUE)
  

  也可手动删除项目目录下的_bookdown_files和_output文件夹，再重新构建整个书籍。

• 排查章节与全局配置冲突
  查看该章节开头的YAML元数据，确认未单独设置number_sections: false或fig_caption: false这类覆盖全局的参数；同时检查_bookdown.yml和_output.yml，确保没有针对该章节的特殊编号排除规则。

• 验证Pandoc版本兼容性
  网页输出依赖Pandoc处理标签逻辑，若使用较旧版本可能存在兼容性问题，升级到最新稳定版的Pandoc后重新编译尝试。

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