Quarto/Pandoc编译HTML遇\x93解码错误，求排查方案

针对你遇到的pandoc.exe: Cannot decode byte '\x93': Invalid UTF-8 stream错误，以下是常规排查之外的可行方法：

• 检查文件实际编码
  用RStudio打开index.qmd，查看右下角显示的编码标识。即使显示为UTF-8，也手动执行转码操作：点击编码选项→「重新编码为UTF-8」，覆盖保存后再尝试渲染。也可通过命令行验证：

  # PowerShell下查看文件中是否存在0x93字节
  Get-Content index.qmd -Encoding Byte | Where-Object { $_ -eq 0x93 }
  

• 排查配置与隐藏文件

  • 单独检查项目配置文件（_quarto.yml、_book.yml）的非ASCII字符：

    tools::showNonASCIIfile("_quarto.yml")
    

  • 删除项目目录下的.Rhistory、.RData等隐藏文件，这些文件可能残留非UTF-8字符干扰渲染。

• 逐字节定位问题字符
  用R脚本扫描文件中的0x93字节位置，精准定位问题点：

  find_invalid_byte <- function(file_path) {
    raw_bytes <- readBin(file_path, "raw", file.info(file_path)$size)
    match_positions <- which(raw_bytes == as.raw(0x93))
    if (length(match_positions) > 0) {
      cat("找到0x93字节位置：", match_positions, "\n")
    } else {
      cat("未找到0x93字节\n")
    }
  }
  find_invalid_byte("index.qmd")
  

  得到位置后，用支持显示所有字符的编辑器（如Notepad++）跳转到对应位置查看。

• 验证Quarto与Pandoc环境
  确认Quarto调用的是升级后的Pandoc版本：

  quarto pandoc --version
  

  如果显示的仍是旧版本，需调整环境变量优先级，让Quarto优先调用你安装的Pandoc 3.1.2。

• 测试路径与最小项目

  • 检查项目所在路径是否包含非ASCII字符（如中文、特殊符号），将项目移至纯英文路径后重试。
  • 新建空白Quarto书籍项目，仅添加# Preface {.unnumbered}内容，若渲染成功，逐步复制原项目的文件到新项目，每次渲染定位引发问题的文件。

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