无法将Quarto文档渲染为PDF的问题求助

问题根源 #

scrartcl.cls是LaTeX的KOMA-Script套件文件，你之前用install.packages()安装是错误操作——这是LaTeX包，并非R包，所以会出现版本不兼容报错。

具体解决步骤 #

• 通过MikTeX安装缺失的LaTeX包

  1. 打开MikTeX Console，切换到「Packages」标签页
  2. 在搜索框输入koma-script，找到后勾选，点击「Install」完成安装
  3. 安装结束后重启RStudio/Quarto，再尝试渲染PDF

• 若MikTeX安装失败，换用TeX Live全量安装
  MikTeX默认按需安装包，偶尔会出现安装异常，TeX Live全量安装包含几乎所有常用LaTeX包，能彻底规避这类问题：

  1. 下载TeX Live完整安装程序，执行全量安装（安装包约3-4GB）
  2. 安装完成后，确保系统PATH环境变量包含TeX Live的bin目录（例如C:\texlive\2024\bin\win32）
  3. 重启电脑后再尝试渲染

• 检查Quarto的LaTeX配置
  在Quarto文档开头的YAML区域，明确指定文档类和LaTeX引擎，示例：

  ---
  title: "你的文档标题"
  format:
    pdf:
      documentclass: scrartcl
      latex-engine: pdflatex
  ---
  

  如果Quarto找不到LaTeX路径，也可通过CLI全局配置：

  quarto config set latex.executable-path "C:\Program Files\MiKTeX\miktex\bin\x64\pdflatex.exe"
  

  （将路径替换为你实际的TeX安装路径下的pdflatex.exe位置）

• 用tinytex自动管理LaTeX环境
  若之前安装过tinytex包，执行以下命令重新安装，它会自动下载并配置所需LaTeX包：

  install.packages("tinytex")
  tinytex::install_tinytex()
  

  安装完成后，重启RStudio再尝试渲染

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