Linux下Quarto生成PDF遇TexLive版本过低错误的解决求助

错误原因 #

本地安装的TeX Live（2020版）与远程软件仓库的版本（2022版）跨了大版本，TeX的包管理工具tlmgr默认不支持跨大版本直接更新，导致Quarto无法自动安装xelatex依赖。你之前尝试的tinytex相关命令可能没有彻底清理旧版本，导致新版本无法正常覆盖生效。

Linux系统下的解决步骤 #

1. 彻底清理旧的TeX环境 #

• 先定位旧版本的安装路径：
  • 系统级TeX Live通常在/usr/local/texlive/2020
  • 用户级TinyTeX通常在~/.TinyTeX
• 删除对应目录：

  # 删除系统级旧版本（需sudo权限）
  sudo rm -rf /usr/local/texlive/2020
  # 删除用户级旧版本
  rm -rf ~/.TinyTeX
  

• 清理环境变量：打开~/.bashrc或~/.zshrc，删除所有包含texlive或TinyTeX的PATH配置行，然后执行：

  source ~/.bashrc  # 若用zsh则执行source ~/.zshrc
  

2. 重新安装最新版TinyTeX #

使用官方脚本直接安装，避免R包安装可能出现的问题：

# 下载并解压最新版TinyTeX到用户目录
curl -sL "https://github.com/r-lib/tinytex/releases/latest/download/TinyTeX.tar.gz" | tar -xz -C ~/
# 将TinyTeX添加到系统PATH
echo 'export PATH="$HOME/.TinyTeX/bin/x86_64-linux:$PATH"' >> ~/.bashrc
# 刷新环境变量
source ~/.bashrc

注意：如果你的Linux是arm64架构，把路径里的x86_64-linux改成aarch64-linux

3. 验证安装并测试Quarto #

• 检查xelatex是否正常可用：

  xelatex --version
  

• 重新运行Quarto生成PDF：

  quarto render test.qmd --to pdf
  

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