> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-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 版本——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 被归类为“Legacy”。提供这些版本是为了确保兼容性，并让需要它们的旧模板和项目能够成功编译。 在考虑使用较旧的 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 需要一段时间！不过，其结果希望能为我们的用户带来更稳定的体验。 尽管我们做了测试，TeX Live 中对 LaTeX、TeX 引擎或必要字体和宏包所做的更新有时仍可能引入我们无法控制的不兼容、破坏性更改和弃用。鉴于 TeX Live 的规模以及它提供的丰富宏包和工具，我们无法排除破坏性更改，但我们会尽最大努力将对用户的影响降到最低。 ### TeX Live 各发行版之间的宏包变化 在年度 TeX Live 发行版之间，TeX 社区仍在不断创新。新的或更新的 LaTeX 宏包、字体以及与 TeX 相关的软件会定期贡献到 Comprehensive TeX Archive Network，在 TeX 社区中简称为 CTAN。CTAN 提供了一个中心仓库，存放可供纳入下一次 TeX Live 发行版的 TeX 和 LaTeX 相关软件。 --- # 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://ayakaleaf-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.