Quarto 每次编译 PDF 文档都会检查和升级 tlmgr 及 LaTeX 包，是 BUG 还是 Feature?

Cloud2016

问题描述

Quarto 每次编译 PDF 文档都会检查和升级 tlmgr 及 LaTeX 包。有时候，不想等了，点了红点🔴，打断进程。后果就是，下次编译文档的时候，开始报错

LaTeX Error: Mismatched LaTeX support files detected.

然后整个 TinyTeX 没法用了，也是上面的原因。如果一直等下去，可能不会出现 Mismatched 的问题。

复现

一个比较简单的示例，如下

---
title: "Quarto 入门"
author: "张三"
lang: zh
format:
  pdf:
    include-in-header:
      - text: |
          \usepackage[heading=true,UTF8]{ctex} 
          \usepackage{amsmath,bm}
    toc: true
    mathspec: true
    number-sections: true
    colorlinks: true
    documentclass: article
    papersize: b5paper
---

# 线性模型 {#sec-lm}

@sec-lm 介绍线性模型，线性模型的矩阵表示见 @eq-lm 。

$$
\bm{\mathsf{y}} = \bm{\mathsf{X}}\bm{\beta} + \bm{\epsilon}
$$ {#eq-lm}

在导言区加载一个本地没有安装的 LaTeX 宏包，就会触发问题。
或者在导言区不加载 bm 包，但正文中使用 \bm 宏命令，也会触发问题。

附

下面是个真实项目的编译日志，仅作参考。

Rendering:
[1/5] index.qmd


processing file: index.qmd
1/9                             
2/9 [unnamed-chunk-1]           
3/9                             
4/9 [fig-rongelap-concentration]
5/9                             
6/9 [fig-gdal]                  
7/9                             
8/9 [unnamed-chunk-4]           
9/9                             
output file: index.knit.md

[2/5] data-preperation.qmd
[3/5] intro.qmd
[4/5] references.qmd
[5/5] appendix-a.qmd

pandoc 
  to: latex
  output-file: index.tex
  standalone: true
  toc: true
  number-sections: true
  top-level-division: chapter
  pdf-engine: xelatex
  variables:
    graphics: true
    tables: true
  default-image-extension: pdf
  
metadata
  crossref:
    chapters: true
  documentclass: book
  papersize: letter
  block-headings: true
  lang: zh
  bibliography:
    - references.bib
  classoption:
    - UTF8
    - twoside
    - openany
    - table
  lof: true
  lot: true
  geometry:
    - tmargin=2.5cm
    - bmargin=2.5cm
    - lmargin=3.0cm
    - rmargin=2.0cm
  colorlinks: true
  link-citations: true
  title: Quarto 中文书籍模版
  author: 黄湘云
  date: 11/23/2022
  
running xelatex - 1
  This is XeTeX, Version 3.141592653-2.6-0.999995 (TeX Live 2023) (preloaded format=xelatex)
   restricted \write18 enabled.
  entering extended mode
  
updating tlmgr

updating existing packages

compilation failed- error
LaTeX Error: Mismatched LaTeX support files detected.
(LaTeX)        Loading 'expl3.sty' aborted!
(LaTeX)        
(LaTeX)        The L3 programming layer in the LaTeX format
(LaTeX)        is dated 2023-08-11, but in your TeX tree the files require
(LaTeX)        at least 2023-08-29.

For immediate help type H <return>.
 ...                                              
                                                  
l.78      \ExplLoaderFileDate{expl3.sty}}
                                         % 

see /Users/xiangyun/Documents/quarto-book/index.log for more information.

环境信息

quarto check

[✓] Checking versions of quarto binary dependencies...
      Pandoc version 3.1.1: OK
      Dart Sass version 1.55.0: OK
[✓] Checking versions of quarto dependencies......OK
[✓] Checking Quarto installation......OK
      Version: 1.3.450
      Path: /Applications/quarto/bin

[✓] Checking basic markdown render....OK

[✓] Checking Python 3 installation....OK
      Version: 3.11.5
      Path: /usr/local/opt/python@3.11/bin/python3.11
      Jupyter: (None)

      Jupyter is not available in this Python installation.
      Install with python3 -m pip install jupyter

[✓] Checking R installation...........OK
      Version: 4.3.1
      Path: /usr/local/Cellar/r/4.3.1/lib/R
      LibPaths:
        - /usr/local/lib/R/4.3/site-library
        - /usr/local/Cellar/r/4.3.1/lib/R/library
      knitr: 1.43
      rmarkdown: 2.24

[✓] Checking Knitr engine render......OK

Cloud2016

updating tlmgr

updating existing packages

不知道编译进程中的这两步在干嘛？按照字面意思是要更新 tlmgr 管理器和所有已安装的 LaTeX 包，如果真是这样，这真的有点吓人！

我期待的是直接报错，给出消息找不到命令或找不到宏包。

Cloud2016

Cloud2016 此外，我本想用 fmtutil-sys --all 重新刷配置，但是提示 fmtutil-sys 命令找不到

fmtutil-sys --all

zsh: command not found: fmtutil-sys

Cloud2016

手动重新安装 texlive-scripts

tlmgr install texlive-scripts

fmtutil-sys 就可以用了。

nan.xiao

我都是使用笨办法一劳永逸地解决这个问题：直接安装全集版 TeX Live，如 TinyTeX-2，texlive-full，或 MacTeX。

Cloud2016

nan.xiao 这个办法应该是最好的，省心省事。现在硬盘空间都不小，1-2 G 的多余空间可以浪费

yihui

Cloud2016 TinyTeX-2 全家桶比 texlive-full / MacTeX 那些全家桶能省一两 G 空间。不过就算装全家桶，也没法彻底一劳永逸，因为每年 TeX Live 三四月份时会更新、CTAN 也在更新中，而老版本的 TeX Live 无法从新一年的 CTAN 中安装或更新包，所以还有微小的可能性你需要每年重装一遍全家桶，不过一年折腾这么一回应该也还能忍受。

Cloud2016

yihui 我突然意识到，安装全家桶只是解决一部分的问题。如果有个宏命令敲错了或者忘了加载某个宏包，Quarto 应该像正常的编译 LaTeX 文档那样直接报 LaTeX 编译错误，而不是来升级我的 tlmgr 管理器和本地安装的 LaTeX 宏包。如果是本地安装的全家桶，那升级起来大概就是漫长的等待。P.S. 我本地从来没有安装全家桶，但安装的宏包也不少。

yihui

Cloud2016 这个应该给个选项可配置，我不知道 Quarto 有没有，但 tinytex 里给了：https://github.com/rstudio/tinytex/blob/a45272c/R/latex.R#L99 options(tinytex.install_packages = FALSE) 就可以了。

nan.xiao

Cloud2016 yihui 我就觉得可能是默认值问题，查了一下还真有这个选项，设置一下 latex-auto-install 好像就可以了。具体的逻辑是在 quarto-cli/src/command/render/latexmk/pdf.ts 实现的。

POC:

---
title: "Untitled"
format:
  pdf:
    include-in-header:
      - text: |
          \usepackage{zzz}
    latex-auto-install: false
---

## Placeholder

得到

compilation failed- missing packages (automatic installed disabled)
LaTeX Error: File `zzz.sty' not found.

Cloud2016

nan.xiao yihui 感谢。