Quarto生成PDF报错：tlmgr返回非零状态码及TinyTeX安装失败

问题梳理 #

• 用Quarto渲染PDF时，系统找不到xelatex工具，自动触发的安装流程失败，提示tlmgr返回非零状态码，且出现法语提示“指定路径未找到”
• 手动安装TinyTeX时，因网络连接超时无法访问GitHub资源，报错os error 10060

可行解决方案 #

1. 换用完整TeX发行版替代TinyTeX #

绕开TinyTeX的网络问题，直接装完整版：

• Windows系统选MikTeX或TeX Live，安装过程中务必勾选xelatex组件，且安装路径不能有中文、空格或特殊字符
• 安装完成后重启Quarto，再尝试渲染PDF

2. 修复TinyTeX安装的网络障碍 #

如果非要用TinyTeX：

• 切换到稳定网络（比如手机热点），或者检查代理设置确保能正常访问GitHub
• 手动下载离线安装包：找到对应系统的TinyTeX离线安装文件，运行安装时选纯英文路径（比如C:\TinyTeX），安装完在终端执行tlmgr update --all更新组件，再试渲染

3. 确认Quarto的PDF渲染配置 #

打开项目的_quarto.yml文件，确保指定xelatex为渲染引擎：

format:
  pdf:
    engine: xelatex

4. 检查系统环境变量 #

• 把TeX发行版的bin目录（比如C:\TinyTeX\bin\win32或C:\Program Files\MiKTeX\miktex\bin\x64）添加到系统PATH环境变量里
• 打开终端输入xelatex --version，能正常输出版本信息再回到Quarto操作

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