将R Markdown文档渲染为PDF文件时出现输出错误

核心问题 #

R Markdown文档可正常导出HTML，但即使是极简无代码、无特殊字符的文档，也无法渲染为PDF，需从LaTeX环境、配置、日志等方面逐一排查。

排查步骤 #

• 先确认LaTeX环境有效性
  R Markdown转PDF完全依赖LaTeX编译链，先排除环境本身问题：

  1. 在R控制台执行 tinytex::install_tinytex() 重新安装TinyTeX（推荐轻量版LaTeX，适配R Markdown）；
  2. 新建纯.tex文件，写入以下内容，用pdflatex命令编译，看能否生成PDF：

     \documentclass{article}
     \begin{document}
     Test Content
     \end{document}
     

  如果这步失败，直接修复LaTeX环境（比如重装、检查PATH配置），不用再查R Markdown的问题。

• 简化YAML配置测试
  从你提供的YAML截图来看，先把配置简化到最基础版本，排除自定义参数干扰：

  ---
  title: "Test PDF"
  output: pdf_document
  ---
  

  用这个极简配置重新渲染，看是否成功。

• 深挖test.log错误信息
  从test.log截图里定位关键错误：

  • 如果提示“XXX.sty not found”，说明缺少LaTeX包，执行 tinytex::tlmgr_install("对应包名") 安装；
  • 如果出现编码相关错误，在YAML里添加 encoding: UTF-8，若有中文需求，改用ctex文档类：

    ---
    title: "中文测试"
    output: 
      pdf_document:
        documentclass: ctexart
    ---
    

  • 重点看pdflatex failed to compile之前的错误行，90%的问题都出在LaTeX层面的具体报错里。

• 更新相关R包
  执行以下命令更新rmarkdown和tinytex，避免因旧包兼容性导致问题：

  update.packages(c("rmarkdown", "tinytex"))
  

  更新后重启RStudio再试渲染。

• 检查系统环境与权限

  • 在R控制台执行 Sys.which("pdflatex")，如果返回空值，说明LaTeX的bin目录没加到系统PATH，手动添加后重启电脑；
  • 确保生成PDF的目录有写入权限，Windows用户可尝试用管理员权限打开RStudio，Mac/Linux用户检查目录权限是否为w。

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