> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/zh-cn/lei-wen-jian/02-overleaf-and-tex-live.md). # 宏包和类文件列表 本文介绍 TeX Live，并概述它在 Overleaf 基于 LaTeX 的排版服务中的使用。 ## TeX Live 简介 [TeX Live](https://www.tug.org/texlive/) 是一个由 [TeX 用户组](https://www.tug.org/)每年发布的自由软件发行版。它提供在所有标准操作系统上支持基于 LaTeX 的排版所需的 LaTeX 宏包、字体、TeX 引擎以及众多软件工具。 TeX Live 是 Overleaf 的一个重要组成部分，因为我们的服务器使用它来编译你的 LaTeX 代码并生成实时 PDF 预览。它还让 Overleaf 用户可以轻松访问每个 TeX Live 版本中包含的 5,000 多个 LaTeX 宏包。 你并不局限于使用最新版 TeX Live 来编译项目，因为 Overleaf 的服务器提供对以往 TeX Live 版本的访问。项目可以轻松 [切换为使用较早版本的 TeX Live](#how-do-i-change-a-projects-tex-live-version)——例如，由于宏包兼容性问题。 ## Overleaf 支持哪些 LaTeX 宏包？ 由于 Overleaf 使用 TeX Live，你可以访问 5,000 多个宏包，包括： * 使用 [pstricks](https://ctan.org/pkg/pstricks-base?lang=en) 和 [TikZ](https://en.wikipedia.org/wiki/PGF/TikZ)。这里有一些 [TikZ 示例](https://www.overleaf.com/latex/examples/tagged/tikz). * 使用 [BibTeX](https://www.bibtex.org/) 和 [BibLaTeX](https://ctan.org/pkg/biblatex?lang=en)。这里有一些 [示例](https://www.overleaf.com/gallery/tagged/bibliography). * 宏包，例如 [fontspec](https://ctan.org/pkg/fontspec) ，它们是 XeLaTeX 和 LuaLaTeX 支持 OpenType 字体所必需的。 你可以在 CTAN 子页面上浏览 TeX 和 LaTeX 宏包列表 [CTAN：宏包](https://ctan.org/pkg/). ## 我的项目使用哪个 TeX Live 版本？ 当你创建新的 Overleaf 项目或复制现有项目时，新建（或复制）的项目默认会使用我们服务器上安装的最新 TeX Live 版本进行编译。当我们为用户提供新的 TeX Live 版本时，不会自动升级现有项目。这样自动升级可能会由于不同 TeX Live 版本之间的差异，而在你现有项目中引发错误或警告。 ### 关于 TeX Live 和你的 Overleaf 项目的补充说明 * 未共享项目所使用的 TeX Live 版本由该项目的所有者控制。但是，如果共享项目中的某位协作者更改了 TeX Live 版本，那么会影响该项目的所有协作者。 * TeX Live 版本是项目特定参数：为某个特定项目更改它，不会影响你在 Overleaf 工作区中的任何其他项目，也不会修改该项目中任何源代码。 * 在选择了特定版本的 TeX Live 之后，你的项目所使用的所有宏包当然都会是该 TeX Live 发行版中包含并发布的版本。 * 切换到不同的 TeX Live 设置可能会改变宏包的行为，例如它们提供的命令发生变化。 * 更改项目的 TeX Live 版本并不是永久性的；你可以在需要时随时恢复到先前版本。务必注意，不同的 TeX Live 发行版可能会有更新/变化，从而影响使用特定 TeX Live 发行版编译项目的能力。 ## 如何更改项目的 TeX Live 版本？ 按以下步骤更改项目的 TeX Live 版本——TeX Live 设置是 *每个项目专属的* ，不会影响你的任何其他项目： 1. 选择 Overleaf 菜单按钮（![Overleaf menu button](/files/9c48876624f712e45241d762e5d0036987d5c31a)），并找到标记为 **设置**. 2. 在 **设置**中，选择标记为 **TeX Live 版本**. 3. 选择你的项目所需的 TeX Live 版本，然后点击菜单列表外任意位置以关闭菜单。 4. 重新编译你的项目，以测试与所选 TeX Live 版本的兼容性。 下图总结了这些步骤——为清晰起见，省略了大部分菜单项： ![展示如何在 Overleaf 中选择 TeX Live 版本的图片](/files/3d7ce6ff7c9977928a36087cbdcbb0dc2ff06c14) ### 为什么要更改项目的 TeX Live 版本？ TeX Live 是一个大型且复杂的软件发行版，因此新版本偶尔引入一些变化，从而导致少数文档无法成功编译，也就不足为奇了。这通常是由于影响宏包命令的更改、意外错误以及宏包不兼容（或“冲突”）。 以下是更改用于编译项目的 TeX Live 版本的一些常见原因。 * **你可能希望将某个现有项目的 TeX Live 版本升级为**。你可以将项目使用的 TeX Live 版本切换到更新的版本，以便使用你想要的宏包、命令或语言功能。不过，在这样做之前，我们建议确保项目能够无错误编译，并且你已理解编译器给出的任何剩余警告。 * **你可能希望复制后的项目使用与原项目相同的 TeX Live 版本**。有时，当你复制一个旧项目时，由于 TeX Live 的变化，新的错误可能会出现。此时，你可以修改项目以兼容最新版 TeX Live，或者将新复制项目的 TeX Live 版本设置为与其所复制的原项目版本一致。 * **你可能需要让 Overleaf 项目所使用的 TeX Live 版本与你本地机器上使用的版本一致**。如果你既在本地也在 Overleaf 中编译项目，为了获得一致的结果，你可能希望调整 Overleaf 使用的 TeX Live 版本，使其与你本地使用的 LaTeX 版本兼容。 * **你可能会向使用特定 TeX Live 版本编译的期刊或仓库投稿**。如果你向使用特定 LaTeX 版本的期刊或仓库投稿，那么在 Overleaf 上使用相同或兼容的 TeX Live 版本编译，可以帮助避免投稿时出错。 ### TeX Live 的“旧版” 在上方截图所示的 TeX Live 版本下拉菜单中，较旧的 TeX Live 版本被归类为“旧版”。提供这些版本是为了确保旧模板和需要它们的项目能够兼容并成功编译。 在考虑使用较旧的 TeX Live 版本时，还有一些其他要点需要注意： * 在开始新项目时，除非存在必须使用旧版本的特定兼容性问题，否则建议使用最新版 TeX Live。这样可以确保你受益于最新的更新和功能。 * 虽然 Overleaf 目前尚未为停止提供最旧版本的 TeX Live 制定时间表，但这些版本最终可能会被逐步淘汰并不可用。 * 在可行的情况下，你现有的项目应更新到最新兼容的 TeX Live 版本。 ## Overleaf 上的 TeX Live 多久更新一次？ Overleaf 的编译服务器会在 TeX Live 最新版本可用后不久升级到该版本。在测试并完成升级后，Overleaf 会发布一篇博客文章，分享任何值得注意的 TeX Live 更新，以及基于我们测试结果给出的与宏包相关的说明和指导。我们的 TeX Live“发行说明”可以在博客上通过以下方式找到： `TeX Live` 标签： . ### 关于 Overleaf 的升级流程 在升级我们的 TeX Live 安装之前，我们会重新编译一套广泛的测试文档，包括模板、示例和文章库中的大约 5,000 篇，以检查是否存在破坏性变更——包括错误以及编译输出中任何显著的视觉变化。我们还会测量文档渲染所需的相对时间。我们会找出明显更慢的渲染并尝试加快它们。基于这些测试的结果，我们会更新我们制作的模板——这就是为什么我们有时更新 TeX Live 需要花费一些时间！不过，希望最终能为我们的用户带来更稳定的体验。 尽管我们进行了测试，LaTeX、TeX 引擎或 TeX Live 中必要的字体和宏包所做的更新有时仍会引入我们无法控制的不兼容性、破坏性变更和弃用。鉴于 TeX Live 的规模以及它提供的丰富宏包和工具，我们无法排除破坏性变更，但我们会尽最大努力将对用户的影响降到最低。 ### TeX Live 版本之间的宏包变化 TeX 社区在每年 TeX Live 发布之间持续创新。新的或更新的 LaTeX 宏包、字体以及与 TeX 相关的软件会定期贡献到综合 TeX 存档网络中，在 TeX 社区中简称为 CTAN。CTAN 提供了一个中心仓库，用于存放与 TeX 和 LaTeX 相关的软件，以便在下一次 TeX Live 发布时纳入其中。 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/zh-cn/lei-wen-jian/02-overleaf-and-tex-live.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.