> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# TeX Live 2026 现已发布

<Info>
  本文档来自 [Overleaf 博客](https://www.overleaf.com/blog/tex-live-2026-is-now-available)。Overleaf 于 2026 年 8 月 18 日发布了 TeX Live 2026。我们也已将 [ayaka-notes/texlive-full](https://github.com/ayaka-notes/texlive-full) 更新到 TeX Live 2026。
</Info>

本文介绍了此次更新的变化、切换前需要检查的事项，以及如何修复最常见的新错误。此版本中最值得关注的更新是：用于生成无障碍 PDF 的功能已经可以用于生产工作流，正式脱离了原型阶段。此次更新还为你带来了新增和更新的 TeX 相关程序、字体和宏包。本文涵盖了你需要了解的所有关键信息和重要变更。

Overleaf 每年在经过严格测试后发布一次官方更新，以确保一切按预期运行。我们这样做是为了给数百万 Overleaf 用户提供一致且稳定的体验，并确保我们的支持团队能够协助你解决任何问题或疑问。

### 什么是 TeX Live？

[TeX Live](https://tug.org/texlive/) 是 TeX 排版系统的免费发行版，包含许多 TeX 相关的程序、字体和宏包（包括 LaTeX），由一群核心 TeX 用户和 [TeX 用户组](https://tug.org/)维护。Overleaf 在其编译服务器上使用 TeX Live 来驱动预览并生成你的项目 PDF。

随着 TeX Live 2026 的推出，用户可以创建完全无障碍的带标签（tagged）PDF，包括可被读取的数学公式。

### 我现有的项目还能照常工作吗？

可以。你现有的项目仍将照常工作，因为它们会继续使用创建时的 TeX Live 版本。除非必要，我们不建议更改现有项目的 TeX Live 版本；更改可能会导致新的错误或警告。

<strong>注意：</strong> Overleaf 模板库中可能有一些模板在启用无障碍选项后无法正常工作或编译。大多数模板并非由 Overleaf 创建或维护；如有任何问题，请联系模板作者。

### 我可以将现有项目切换到 TeX Live 2026 吗？

可以，你可以轻松地将现有项目切换到 TeX Live 2026，整个过程简单省心。在要更改的项目中打开 *Settings*，然后点击侧边栏中的 *Compiler*，你会看到一个用于选择 TeX Live 版本的下拉菜单。这样你就可以快速更新项目，以满足出版商、预印本服务器以及其他使用特定 TeX Live 版本编译投稿的平台的要求。

如果你的项目在 TeX Live 2025（或更早版本）中编译正常，但在 TeX Live 2026 中报错，这可能是由于内核或某些宏包的变更所致。已知某些宏包在 TeX Live 2026 下会产生新的错误或警告；我们在下文的单独章节中汇总了最常见的问题及其修复方法。

### TeX Live 2026 的主要变化

#### 带标签的无障碍 PDF 已脱离原型阶段

自 LaTeX Project 的 [2025 年 11 月更新](https://www.latex-project.org/news/latex2e-news/ltnews42.pdf)以来，标签功能不再被描述为原型，而是被认为可以用于生产工作流——前提是你的文档只使用已经支持标签功能的宏包和文档类。

启用带标签的 PDF 输出只需在 `\documentclass` 之前放置一条命令：

```latex theme={null}
\DocumentMetadata{
 pdfstandard = {UA-2, A-4f},
 tagging = on,
 lang = en
 }
\documentclass{article}
```

使用 `\DocumentMetadata` 还会开启一些默认设置：T1 字体编码，以及[自 2025 年 6 月起](https://www.latex-project.org/news/latex2e-news/ltnews41.pdf)输出 **PDF 2.0** 而非较旧的 1.7 版本。PDF 2.0 在这里很重要，因为正是它支持 MathML 标签（这让屏幕阅读器能够读取数学公式，而不是面对一堵无标注的符号墙）。

一些实用说明：

* 在起草阶段，你可以设置 `tagging = draft`，保留无障碍警告但跳过结构树的写入（对加快长文档的编译很有用）。
* check-tagging-status 键会在日志末尾报告你所使用的宏包是否已知与标签功能兼容。你还可以在开始之前查看一个[实时状态数据库](https://latex3.github.io/tagging-project/tagging-status/)。
* 如果你只需要 PDF 管理功能而不需要标签代码，现在有一个单独的 `pdfmanagement` 宏包可供使用。

有一项变更特别值得注意：`\DocumentMetadata` 现在在一个文档中只能调用一次。第二次调用会导致编译错误，就像第二次使用 `\documentclass` 一样。

#### 带语义的无障碍数学公式

[自 2025 年 11 月起新增](https://www.latex-project.org/news/latex2e-news/ltnews42.pdf)的 `\MathMLintent` 和 `\MathMLarg` 允许作者告诉辅助技术某个记号的含义，而不仅仅是它的构成方式。例如，`|y|` 现在可以被朗读为 *“y 的绝对值”*，而不是 *“竖线 y 竖线”*。

无障碍数学标签需要使用 LuaLaTeX 编译（因为它是生成 MathML 的引擎），并且需要使用 `unicode-math` 或 `lua-unicode-math` 宏包。

#### 图形和插图现在也能承载语义

无障碍功能不仅限于文本和数学公式。`\includegraphics`、`picture` 和 `tikzpicture` 现在都接受无障碍相关的键，因此可以对每个图形进行恰当的标注：

```latex theme={null}
\includegraphics[alt={A bar chart of quarterly revenue}]{revenue}
```

图形可以分为四类：真正的说明性插图、应被辅助工具忽略的装饰性元素、符号的替代品，或普通文本（适用于 `todonotes` 之类的情况）。TikZ 输出开箱即用地受到支持。

#### 用于创建带标签无障碍演示文稿的新文档类

`beamer` 文档类在 LaTeX 中制作演示幻灯片时非常流行。遗憾的是，它与 LaTeX 标签代码不兼容。为此，一个全新的文档类 [`ltx-talk`](https://ctan.org/pkg/ltx-talk) 从零开始被创建出来。它的语法与 `beamer` 大体相似，但 `ltx-talk` 尚未实现 `beamer` 的全部功能。

#### 用于设置章节标题样式的新模板机制

章节标题命令已在 LaTeX 内核中借助新的模板机制重新实现，解决了 `titlesec` 等宏包与 LaTeX 标签代码不完全兼容的问题。下面是一个简单示例：

```latex theme={null}
\EditInstance{heading}{section}{
  number-format=\fbox{\LARGE\bfseries\theheading},
  title-decls=\Large\bfseries\sffamily\color{blue},
  before-vspace=20pt,
}
```

详细信息请参阅[文档](https://tug.ctan.org/macros/latex-dev/required/latex-lab/latex-lab-sec-template.pdf)。

#### 底层重构的内核

在今年的内核中，一些限制已被移除：

* <strong>输出例程现在可配置：</strong> 近 40 年来，LaTeX 的页面组装机制实际上是硬编码的，需要修改它的宏包不得不覆盖内部代码。现在它提供了钩子（hooks）和插槽（sockets）来进行修改。宏包因此变得更加稳定，也更不容易相互冲突。
* <strong>现代化的标记机制：</strong> 旧的 `\markboth` / `\leftmark` / `\rightmark` 系统只支持两个相互交织的标记，现已基于一个灵活的系统重建，支持任意数量的独立标记，同时那些熟悉的命令仍然与以前完全一样地工作。
* <strong>块环境和章节标题现在基于模板运行：</strong> 列表、引用、类定理环境以及现在的标题命令共享一个一致的底层系统。一个实际的好处是：LaTeX 正开始原生模拟 `enumitem` 和 `amsthm` 的 `\newtheoremstyle` 等流行宏包，`titlesec` 的模拟也在进行中。现在仅仅为了重新设置列表或定理框的样式而安装宏包的需求减少了。
* <strong>类定理环境的交叉引用更完善：</strong> 新的 `\newcounteralias` 命令意味着，与定理共享计数器的引理在通过 `cleveref`、`zref-clever` 或 `hyperref` 引用时，会正确显示为 *“lemma 1”*，而不是 *“theorem 1”*。

如果你维护的是宏包而不仅仅是文档，有两项变更值得关注：内核现在正式要求 **日期为 2023-11-27 或更新的 `expl3`**；此外，*“伪数学”*（仅为定位盒子而使用数学模式）已从 `\textsuperscript`、`\parbox`/`minipage` 等结构以及表格结构周围移除。这改善了标签功能和从右到左文本的支持，但如果你将 `\showoutput` 的结果与旧版 TeX Live 进行比较，就会注意到这一差异。

#### 新的覆盖范围：更多语言

* <strong>婆罗米系文字的索引功能</strong>（包括孟加拉文、古吉拉特文、卡纳达文、马拉雅拉姆文、僧伽罗文、泰米尔文和泰卢固文）已在 `upmendex` 中以实验性方式推出。
* 新的 **BCP 47 语言元数据**键（`language`、`other-languages`）让你可以精确声明文档的语言，细化到地区变体，这些信息也会写入 PDF 自身的语言元数据中。

#### 其他需要注意的事项

* `enumerate`、`theorem` 和 `verbatim` 宏包现在被视为旧版宏包；对于新文档，请分别优先使用 `enumitem`、`amsthm` 和 `fancyvrb`。
* 如果你使用的打印工作流或平台需要较旧的 PDF 版本，你仍然可以自行设置 PDF 版本（例如 `\DocumentMetadata{pdfversion=1.7}`），TeX Live 2026 文档中也介绍了如何按照较早的默认设置编译文档。
* 你可以在 TeX 用户组（TUG）网站上找到 TeX Live 2026 的[官方发行说明](https://tug.org/texlive/doc/texlive-en/texlive-en.html#news)，以及[所有 TeX Live 版本的发行说明](https://www.tug.org/texlive/doc/texlive-en/texlive-en.html#x1-710009)。

### 受 TeX Live 2026 影响的常见宏包

在以下各节中，我们重点介绍一些会导致在 TeX Live 2025 中编译成功的项目在 TeX Live 2026 中出现编译错误的变更。

#### 不再支持的表格相关宏包

由于 LaTeX 内核中表格结构的新变更，`tabu` 和 `tabls` 宏包在 TL2026 中不再受支持——它们现在会导致编译错误。`arydshln` 宏包也可能与其他宏包不兼容，例如 `tabularx` 和 `tabular*` 环境。同样，重新定义 `\@array` 和 `\tabular` 的宏包或模板也会在类表格结构周围导致编译错误。

#### `babel` 已废弃的语言选项

`frenchb` 和 `francais` 语言选项现已废弃，应替换为 `french`。

#### `varioref` 的 bug

由于 [`varioref` 宏包中的一个 bug](https://github.com/latex3/latex2e/issues/2112#issuecomment-4881772493)，在 KOMA-Script 文档类中加载它会导致 TeX capacity exceeded 错误，并且不会生成 PDF。

```text theme={null}
\documentclass{scrartcl}
\usepackage{varioref}
\begin{document}
Hello World!
\end{document}
```

解决方法是在导言区添加

```text theme={null}
\def\extrasenglish{}
```

#### KOMA-script 文档类与 `capt-of`

KOMA-script 文档类（`scrbook`、`scrartcl`、`scrreport`、`scrletter`）现在定义了 `\captionof`，因此不应再加载 `capt-of` 宏包。（另一方面，`caption` 宏包仍然可以安全地与这些文档类一起加载。）

#### `thmtools`：`sibling`/`numberlike`/`sharenumber` 错误

使用 `thmtools` 的 `sibling`（或 `numberlike`、`sharenumber`）选项声明新的类定理环境时，会出现[计数器已被定义的错误](https://github.com/muzimuzhi/thmtools/issues/75)，例如 `Command \c@proposal already defined`。

```text theme={null}
\documentclass{article}
\usepackage{thmtools}
\declaretheorem{theorem}
\declaretheorem{proposal}[sibling=theorem]

\begin{document}

\begin{theorem}This is a theorem.\end{theorem}
\begin{proposal}This is a proposal.\end{proposal}

\end{document}
```

解决方法是在导言区中、加载 `thmtools` 之后且在 `\declaretheorem` 之前添加以下几行：

```text theme={null}
\makeatletter
\@ifundefined{newcounteralias}{}{%
  \renewcommand\thmt@autorefsetup{\@xa\def\csname\thmt@envname autorefname\@xa\endcsname\@xa{\thmt@thmname}}%
}
\makeatother
```

#### `polyglossia`、`xepersian` 与 `array`

如果你使用 `polyglossia` 或 `xepersian` 宏包排版阿拉伯文字，并且加载了 `array` 宏包或其他会加载 `array` 的表格相关宏包，那么当阿拉伯文本位于类表格结构中时，你会遇到 `\UseMathForPositioningText` 未定义的错误。

```text theme={null}
\documentclass[12pt,a4paper]{article}
\usepackage{polyglossia}
\usepackage{array}
\setdefaultlanguage{arabic}
\newfontfamily\arabicfont[Script=Arabic]{Noto Naskh Arabic}
\begin{document}
\begin{tabular}{c}
السلام عليكم
\end{tabular}
\end{document}
```

可以通过在 `\documentclass` 声明之前添加 `\DocumentMetadata{}` 来解决；或者考虑改用 `babel` 宏包来排版阿拉伯文字。

#### `babel-spanish` 与 `biblatex-apa`

在使用 `biblatex` 的 `apa` 样式时加载 `babel-spanish`，会导致一个与钩子和 `\@makecaption` 相关的编译错误：

```text theme={null}
\usepackage[spanish]{babel}
\usepackage[style=apa]{biblatex}
```

不过，为 `babel` 添加 `shorthands=off` 选项即可避免该错误。

#### `xgreek`、`hyperref` 与 `\appendix`

当加载 `xgreek`（仅适用于 XeLaTeX 和 LuaLaTeX）和 `hyperref` 宏包时，出现在 `\appendix` 之后的章节标题会引发编译错误：

```text theme={null}
\documentclass{article}
\usepackage{xgreek}
\usepackage{fontspec}
\setmainfont{GFS Artemisia}
\usepackage{hyperref}
\begin{document}
\section{Εισαγωγή}
\appendix
\section{Δεδομένα}
\end{document}
```

修复方法是为 `hyperref` 添加 `hypertexnames=false` 选项。

#### `flowfram` 与 `titlesec`

目前 `flowfram` 和 `titlesec` 宏包互不兼容。不过，作者可以考虑使用新的 `\EditInstance` 接口来设置章节标题样式，例如：

```text theme={null}
\DocumentMetadata{}
\documentclass{article}
\usepackage{flowfram}
\usepackage[dvipsnames]{xcolor}
\EditInstance{heading}{section}{
  number-format=\fbox{\LARGE\bfseries\theheading},
  title-decls=\Large\bfseries\sffamily\color{NavyBlue}
}
\begin{document}
\section{Introduction}
\end{document}
```

更多详情请参阅[此链接](https://mirrors.ctan.org/macros/latex-dev/required/latex-lab/latex-lab-sec-template.pdf)。

### Ayakaleaf Pro 中的 TeX Live 2026

Ayakaleaf Pro 管理员可以按照通常的方式更新配置来安装 TeX Live 2026：将 `TEX_LIVE_DOCKER_IMAGE`（以及 `ALL_TEX_LIVE_DOCKER_IMAGES`）指向新的 TeX Live 2026 镜像即可，无需进行其他升级。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.