为什么R渲染bookdown文件为HTML时会在文件路径中添加%22？

修复方案 #

%22是双引号的URL编码，该问题由路径多余嵌套引号、旧版本bookdown渲染缺陷导致，可按以下步骤排查解决：

• 升级bookdown到最新版本
  运行R命令更新安装包：

  install.packages("bookdown")
  

  旧版本bookdown的gitbook渲染器存在自动给路径套多余引号的已知bug，升级后可修复绝大多数同类问题。
• 检查所有Rmd文件的资源路径写法
  不要给图片、链接的路径加额外的双引号包裹：
  错误写法：

  ![示例图]("./imgs/plot1.png")
  

  正确写法：

  ![示例图](./imgs/plot1.png)
  

  同时检查代码块中生成图片的输出路径参数，避免多余的引号嵌套。
• 检查项目配置文件
  打开根目录下的_output.yml，检查gitbook相关的路径配置项（包括编辑链接、下载链接、目录配置对应的路径参数），删除多余的引号包裹。
• 自动批量修正兜底方案
  如果上述排查后问题仍存在，可以直接写脚本在渲染完成后自动替换所有HTML中的%22字符，无需手动修改：

  # 执行渲染
  bookdown::render_book("index.Rmd", "bookdown::gitbook")
  # 批量处理输出目录的所有HTML文件
  output_path <- "_book" # 替换为你的实际输出目录路径
  html_list <- list.files(output_path, pattern = "\\.html$", full.names = TRUE, recursive = TRUE)
  for (file in html_list) {
    content <- readLines(file, encoding = "UTF-8")
    modified_content <- gsub("%22", "", content)
    writeLines(modified_content, file, useBytes = TRUE)
  }
  

  每次运行上述脚本即可完成渲染+路径修正的全流程操作。

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