TeX Live 2023 安装避坑指南：Windows/Mac 双平台实测（含常见错误解决方案）

TeX Live 2024 实战部署：跨越 Windows 与 macOS 的完整工作流构建

又到了论文季，或是需要撰写一份漂亮技术文档的时候，身边总会有朋友开始折腾那个让人又爱又恨的 LaTeX。爱的是它那无与伦比的排版质量和学术范儿，恨的往往是第一步——安装。你或许已经搜过无数教程，下载了几个G的安装包，却在某个步骤卡住，面对命令行里看不懂的错误信息束手无策。别担心，这篇文章就是为你准备的。我将结合最近在 Windows 11 和 macOS Sonoma 上的实际部署经验，带你一步步搭建一个稳定、高效且易于维护的 LaTeX 环境。我们的目标不仅仅是“装上能用”，而是构建一个让你在未来几年内都能安心写作的坚实基石，无论是处理复杂的中文论文，还是包含大量图表和参考文献的书籍项目。

1. 核心理念：为何选择 TeX Live 及其现代安装哲学

在开始点击“下一步”之前，我们有必要先统一思想。LaTeX 发行版主要有 TeX Live、MiKTeX 和 MacTeX（后者本质是 TeX Live 的 macOS 定制版）。对于追求长期稳定和跨平台一致性的用户，TeX Live 几乎是唯一的选择。它由国际 TeX 用户组织维护，每年更新一次，包含了绝大多数你会用到的宏包，其“一次安装，基本无忧”的特性，避免了在写作关键时刻因网络问题在线下载宏包而中断的尴尬。

然而，传统的“完整安装”动辄占用 5GB 以上空间，且安装过程漫长。现代的安装哲学更倾向于 “按需部署” 和 “环境隔离”。我们不再推荐从 DVD 镜像或庞大的 ISO 文件安装，而是通过更灵活的包管理器和定制化安装脚本。对于新手，这听起来更复杂，但实际上，它能从根本上避免许多因路径冲突、版本混杂导致的经典“坑点”。

提示：无论使用 Windows 还是 macOS，请务必以管理员/超级用户权限进行安装操作，并暂时关闭所有实时防病毒软件，以免其误拦截安装程序对系统路径的修改。

1.1 安装前的关键决策：安装媒介与版本选择

首先访问 TUG 的 TeX Live 主页。你会看到几种安装方式：

• 网络安装镜像：一个很小的引导程序，安装过程中从网络下载所需组件。不推荐，除非你的网络极其稳定快速，否则数小时的下载过程极易中断。
• 完整 ISO 镜像：包含所有内容的离线安装包。这是最稳妥的方式，尤其在国内网络环境下。
• 第三方包管理器：如 macOS 的 Homebrew、Windows 的 Chocolatey 或 Scoop。适合喜欢命令行、追求环境可复现的进阶用户。

我的建议是：首次安装，请下载完整 ISO 镜像。对于 2024 版，文件名为 texlive2024.iso，大小约 4.5 GB。下载后，Windows 用户可以直接挂载（Win8及以上系统内置支持）；macOS 用户双击即可挂载。

关于版本，始终安装最新年度版。TeX Live 具有良好的向后兼容性，用新版本编译旧文档几乎不会有问题，反之则可能因缺失宏包或特性而报错。

2. Windows 平台：从零部署到深度配置

Windows 上的 TeX 环境问题最为集中，主要源于路径权限、中文字符支持和杀毒软件的干扰。我们采用“安装程序 + 手动校验”的组合拳来确保万无一失。

2.1 执行安装与路径避坑

挂载 ISO 后，以管理员身份运行根目录下的 install-tl-windows.bat。这会启动一个命令行界面的安装程序。别被其简陋的界面吓到，这正是其稳定性的体现。

首先，程序会显示一个可编辑的安装配置。这里有几个关键选项需要修改：

Selected scheme: scheme-full (修改为 scheme-medium 或 scheme-small)
TEXDIR: C:\texlive\2024 (强烈建议保持默认，勿安装在Program Files或含空格的路径下)
TEXMFLOCAL: C:\texlive\texmf-local
TEXMFHOME: C:\texlive\texmf-home
TEXMFVAR: C:\texlive\2024\texmf-var
TEXMFCONFIG: C:\texlive\2024\texmf-config

scheme 选择：除非你确定需要所有语言、字体和宏包，否则 scheme-medium 完全足够，它能节省近 2GB 空间。scheme-small 则更精简，后续可通过包管理器 tlmgr 随时添加所需宏包。

路径 是重中之重。C:\texlive\ 是最佳选择，它简短、无空格、无特殊字符，能避免一系列由路径解析引发的诡异错误。绝对不要安装到 C:\Program Files\ 下，其严格的权限控制会导致后续包管理失败。

配置好后，按下 I 键开始安装。这个过程会持续 30 分钟到 1 小时，请耐心等待。

2.2 环境变量配置与验证

安装完成后，必须重启命令行终端（如CMD或PowerShell），让系统刷新环境变量。然后进行验证：

# 打开新的 PowerShell 或 CMD
tex --version
xelatex --version
pdflatex --version

如果这些命令能正确输出版本信息（如 TeX Live 2024），说明核心引擎安装成功。接下来，测试一个最简单的中文文档，以验证 XeLaTeX 和字体系统工作正常。创建一个文件 test.tex：