Bookdown项目渲染后章节HTML文件为空问题求助

• 章节Rmd文件命名不符合规范
  bookdown默认会按文件名排序识别章节文件，要求所有章节Rmd文件必须以数字开头（如01-intro.Rmd、02-blocks.Rmd），如果文件名没有数字前缀、包含中文/空格/特殊符号，会导致渲染时跳过对应文件，生成的章节HTML为空。
• Gitbook输出的拆分规则配置错误
  检查_output.yml中bookdown::gitbook的split_by参数，如果你设置为none会仅生成一个完整的index.html，其他章节HTML会为空，正常分页渲染可设置split_by: chapter或者split_by: section。
• YAML配置冲突
  仅需要在项目根目录的index.Rmd、_bookdown.yml、_output.yml中配置全局YAML参数，单独的章节Rmd文件不需要添加独立YAML头部，否则会和全局配置冲突，导致章节内容无法写入对应HTML。
• _bookdown.yml配置错误
  检查_bookdown.yml中是否手动设置了rmd_files参数，如果你手动指定了渲染文件列表但漏加了对应章节、或者文件路径写错，就会出现章节内容为空的问题。无特殊需求不需要手动设置该参数，让bookdown自动扫描符合规则的Rmd文件即可。
• 缓存文件损坏
  之前渲染生成的缓存、临时文件损坏会导致渲染异常，可先删除项目根目录下的_book文件夹、_cache文件夹，再重新执行knit操作，即可解决多数缓存导致的异常。
• 版本兼容性问题
  你使用的R 3.6.0、RStudio 1.3.959版本较旧，和高版本bookdown存在兼容问题。可先运行packageVersion("bookdown")查看当前bookdown版本，若版本高于0.24，可执行remotes::install_version("bookdown", version = "0.21")降级到适配旧R环境的版本后重新渲染。

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