Quarto 1.2.269更新后在RStudio中调用XeLaTeX编译挂起求助

可能原因 #

Quarto 1.2.269版本默认启用了自动检查TeX包更新的机制，即便你已手动完成TeXLive全量更新，它仍会调用tlmgr执行更新检查。在Windows环境下，tlmgr可能因需要交互确认（如权限弹窗、更新提示）但未在前台显示，导致编译流程挂起。

解决步骤 #

• 禁用Quarto自动TeX更新
  单文档配置：在你的Quarto文档YAML头部添加以下内容：

  ---
  title: "你的文档标题"
  format:
    pdf:
      engine: xelatex
  tex:
    update: false
  ---
  

  全局配置：在用户目录下创建/修改_quarto.yml文件，添加：

  execute:
    tex:
      update: false
  

• 确认RStudio的TeX路径配置
  打开RStudio，依次进入Tools > Global Options > Quarto > PDF：

  • 在"LaTeX engine"中选择你本地TeXLive的XeLaTeX完整路径（例如C:\texlive\2023\bin\win32\xelatex.exe）
  • 确保"Use tinytex"选项未被勾选，避免Quarto使用自带的轻量TeX环境

• 编译时强制跳过更新检查
  在RStudio的Terminal中执行编译命令，添加--no-tex-update参数：

  quarto render your-document.qmd --pdf-engine=xelatex --no-tex-update
  

• 清除Quarto缓存
  删除文档所在目录下的_quarto_cache文件夹，再重新编译，排除旧缓存的干扰

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