做学术排版的人，十个里有九个第一句会问：LaTeX 到底怎么装？这个看似基础的问题，其实坑不少——官网入口藏得深、发行版选不对、编辑器配不好，每一步都可能让新手卡壳。我当年第一次装 TeX Live 的时候，光是在线安装就等了快两个小时，中途断网直接白干，后来换了方案才顺利跑通。这篇就把我这两年反复安装、帮同事救场的经验一次性说清楚，从官网下载到环境配置，再到编辑器联动和常见报错排查，按 2022 年最新官方版本的操作路径走一遍，照着做基本不会出岔子。
1. 安装前必须想清楚的三件事
1.1 LaTeX 不是一个软件，而是一套工具链
先纠正一个最常见的误解：很多人以为 LaTeX 是一个像 Word 一样的软件，下载安装完就能打字排版。实际上，LaTeX 是一套基于 TeX 排版引擎的宏语言系统，它由编译器、宏包、字体、文档类等多个部分组成。我们平时说的“安装 LaTeX”，本质上是在安装一个发行版，这个发行版把 TeX 引擎、LaTeX 格式、常用宏包、文档模板、字体文件等打包在一起，让你能直接使用。
用生活化的类比来说：TeX 引擎相当于发动机，LaTeX 是标准的驾驶规则，而发行版就是一辆组装好的整车。你不需要自己去造发动机，也不需要研究怎么把零件拼起来，安装发行版就是直接开上这辆车。目前主流的发行版有两个：一个是 TeX Live，跨平台且开源免费，官网更新最及时；另一个是 MacTeX，本质上是 TeX Live 的 macOS 定制版，针对苹果系统做了优化。Windows 用户直接用 TeX Live 就够了，macOS 用户则可以二选一，但绝大多数人最终都会落到 TeX Live 上，因为它在中文字体支持、宏包齐全度方面都有明显优势。
1.2 2022 年官方推荐方案为什么值得选
很多教程会让你用国内的 CTEX 套装或者老的 MiKTeX，但我的建议是，能走官方就走官方。2022 年的 TeX Live 版本号已经到了 2022（对应每年一度的年度发布），它最大的好处是宏包更新及时、bug 修复快，而且安装完成后自带完整文档。
官方推荐方案的具体含义是：从 tug.org 官网下载 TeX Live 或者 MacTeX，而不是从第三方镜像站下载来路不明的安装包。为什么强调官网？因为我见过不少人图省事，随便搜个链接就下载，结果装到一半报错，或者装完发现缺少关键组件，更有甚者下载到了捆绑广告软件的修改版。官网路径是 install-tl（Windows 上是 install-tl-windows.bat，macOS 上是 MacTeX.pkg），下载后运行就是一整套标准流程。
官方方案还有一个好处：它提供了真实的安装校验。TeX Live 官网放出了 MD5 和 SHA256 校验值，下载完可以核对文件完整性，这一点在第三方镜像站往往被忽略。对于科研论文投稿、毕业设计排版这种场景，工具链的可靠性直接影响最终文档质量，值得多花这几分钟。
1.3 适用场景与学习成本预期
结合我自己的体会，适合选择 LaTeX 的人群很清晰：需要大量公式排版的理工科学生和科研人员、需要精确控制版式的出版社和期刊投稿作者、厌倦了 Word 页码错乱和图表漂移的用户。如果你只是偶尔写一页简单文档，LaTeX 的初期学习成本可能略高，不值得。但如果你要写学位论文、期刊论文、实验报告这种长文档，LaTeX 的自动化交叉引用、参考文献管理、公式排版能力远比 Word 可靠。
安装本身的学习成本其实很低，难的是装完之后怎么用。通常我会建议新手预留半天时间，把安装和编辑器配置跑通，再用一个周末熟悉基本语法。这篇文章能帮你把第一关“安装配置”在半小时内搞定，后面就是语法学习和模板套用的事了。
2. 官网安装全流程：Windows / macOS / Linux 三平台实操
2.1 Windows 平台安装 TeX Live 2022 详细步骤
先说 Windows 用户最关心的步骤。打开浏览器进到 TUG 官网首页，找到 Download 栏目下的 TeX Live 链接，点击进去会看到 install-tl-windows.exe 和 install-tl-windows.bat，后者是命令行安装脚本，前者是图形化启动器。很多人兴冲冲点了 exe，结果发现它只是拉起了命令行界面，就有点懵。实际上 TeX Live 的安装程序在 Windows 上始终是命令行交互的，我第一次装的时候也愣了一下，后来才明白这是它的设计习惯：用 Perl 写的安装脚本，跨平台统一逻辑。
具体操作步骤如下：
- 下载 install-tl-windows.exe，双击运行。如果系统提示 SmartScreen 拦截，选择“仍要运行”，这是因为安装脚本没做数字签名，官方原版就是这样，可以放心通过。
- 程序会询问安装方案，默认是
scheme-full，即完整安装，包含所有宏包和文档。新手直接回车默认即可，不要为了省磁盘空间选精简方案，否则以后编译时缺宏包会很头疼。 - 安装目录默认是
C:\texlive\2022，保留默认即可。如果你 C 盘空间紧张，也可以改成 D 盘或其他位置，但路径中不要出现中文和空格，这是 TeX 工具的常见要求。 - 安装过程会显示进度条，完整安装的耗时和网速强相关。我实测在 50M 宽带下大约需要 40~60 分钟，如果网络不稳，可以改用国内镜像源，这个后面第 5 节细说。
- 安装完成后，脚本会提示你添加系统环境变量。一般来说 install-tl 会自动把
C:\texlive\2022\bin\windows加入 PATH，但某些情况下没有生效，需要手动添加。验证方法：新开一个终端窗口，输入latex --version，如果能输出版本信息就说明环境变量配置成功。
补充一个关键点：2022 版 TeX Live 中的默认引擎是 pdfTeX 和 XeTeX 两个都有，但中文用户建议以后统一用 XeLaTeX 编译，它对 Unicode 和中文字体支持更完善。这个编译引擎的选择属于使用层面的问题，但安装阶段要确保相关宏包都在，完整安装方案没什么好担心的。
2.2 macOS 平台安装 MacTeX 与 TeX Live
macOS 用户有两个选择：安装 MacTeX 或直接安装 TeX Live。MacTeX 实际上预装了 TeX Live 的全部内容，还额外包含了 TeX Live Utility（宏包更新工具）和 TeXShop（自带编辑器），对新手更友好。
MacTeX 的安装包是一个 pkg 文件，体积大概 4~5 GB，比 Windows 的 TeX Live 大不少，原因是它集成了更多的 GUI 工具和字体。下载完双击 pkg，按提示一路“继续”到安装完成即可。安装过程需要管理员权限，会写入/usr/local/texlive目录。
如果你不想用 MacTeX，也可以用 install-tl 脚本在 mac 上装纯净版 TeX Live，但我个人不太推荐新手这么做，因为兼容性调起来麻烦。比如 macOS 对/usr/local目录的权限管理比较严格，纯命令行安装容易遇到权限问题，而 MacTeX 的 pkg 安装器已经处理好了这些细节。
安装完成后，打开终端输入which xelatex，如果返回路径说明安装成功。MacTeX 还会默认把 TeXShop 安装到应用程序目录，你可以先用它写几行测试代码，确保引擎工作正常。这个步骤虽然简单，但能帮你避开后面编辑器配置时“全是问题却发现是引擎没装好”的尴尬。
2.3 Linux 平台的三种安装方式对比
Linux 用户装 LaTeX 有几种常见方式，我按推荐优先级排序说明。
第一种是发行版软件源安装，比如 Ubuntu 的sudo apt install texlive-full，Debian 用sudo apt install texlive-full，Fedora 用sudo dnf install texlive-scheme-full。这种方法优点是命令简单，缺点是软件源里的版本通常滞后半年到一年，有些宏包不够新。如果你投稿的期刊要求的宏包版本较老，这反而是个优势；如果要紧跟最新特性，就选下面两种。\n第二种是官方脚本安装，从 tug.org 下载 install-tl，解压后运行./install-tl --gui或纯命令行。官方脚本的好处是版本最新、可定制性强，但安装时间同样较长。安装完成后需要配置 PATH，在~/.bashrc里加一行export PATH=/usr/local/texlive/2022/bin/x86_64-linux:$PATH，这是很多 Linux 新手容易漏掉的一步。\n第三种是用 Docker 镜像，docker pull tug/latex。这种方式适合不想污染本机环境、或者需要固定版本复现论文结果的场景。但日常写作不推荐，因为每次编译都要进容器，文件交互麻烦。
我个人的建议是：如果是 Ubuntu 用户，直接用texlive-full起步最快；如果你需要最新宏包且愿意折腾，再上官方脚本。装完记得验证tex --version。
2.4 安装过程中的关键参数选择：完整版还是精简版
新手安装 TeX Live 时，面临的最大选择就是scheme-full和scheme-small的取舍。我的态度很明确：直接完整版，别犹豫。\n完整版大概占用 7~8 GB 磁盘空间，安装耗时也更长，但它把所有宏包都装好了，你之后写文档遇到的绝大多数包都不需要额外安装。精简版只有几百 MB，装起来快，但等你要用某个宏包时，得用 tlmgr 单独安装，而 tlmgr 在 Windows 上设置镜像源、处理依赖的过程对新手并不友好，报错概率不低。\n我见过太多人在精简版上浪费时间：写论文需要用algorithm2e，结果没有；投期刊要IEEEtran，也没有。折腾半天，最后还是回头装完整版。磁盘空间不够的话，清理一下其他没用的软件，或者换到 D 盘，但别在安装方案上妥协。\n还有一个参数值得提：安装时可以选择“仅安装当前平台”还是“全部平台”。默认是当前平台，保持默认就行。选全部的话不仅浪费空间，还会拖慢安装速度，没有任何实际收益。\n另外，如果你对排版中文有刚需，装完 TeX Live 后建议用tlmgr install ctex检查一下 ctex 宏包是否完整。完整版默认含 ctex，但确认一下没有坏处。
3. 编辑器配置：让 LaTeX 真正好用起来
3.1 自带编辑器 TeXworks 的定位与局限
TeX Live 安装包默认带一个简单的编辑器 TeXworks，对于零基础用户来说，它最大的意义是“开箱即用”：打开它，写几行代码，点一下绿色编译按钮，就能看到 PDF 输出。这个体验对新手建立信任感很重要，装完 LaTeX 之后第一件事就应该用它跑通一个最简单的文档，确认工具链没问题。\n但 TeXworks 的局限也很明显：没有代码自动补全、没有实时拼写检查、没有正向反向搜索的快捷键提示、对长文档的目录结构管理很弱。所以它只能作为验证工具，日常写作我基本不用。很多教程会让新手一上来就在 TeXworks 里打字，结果体验很差，误以为 LaTeX 很难用。\n正确的路径是：先用 TeXworks 确认安装成功，然后立刻换到功能更强的编辑器。
3.2 VS Code + LaTeX Workshop：目前最适合新手的组合
我在多个平台实测下来，VS Code 配合 LaTeX Workshop 插件是目前对新手上手最友好的方案，理由有三个：基础体验好、配置简单、跨平台一致。\n第一步，下载安装 VS Code，这步不再多说。\n第二步，在扩展商店搜“LaTeX Workshop”，点 Install。这个插件能识别你系统中的 TeX Live 安装，自动配置编译命令。\n第三步，打开一个.tex文件，按下Ctrl+Alt+B（macOS 是Cmd+Option+B），插件会调用默认的 pdflatex 编译并弹出 PDF 预览。\n需要强调的是，LaTeX Workshop 默认的编译引擎是latexmk，它能够根据文档内容自动选择合适的引擎。但对于中文用户，我建议在 VS Code 设置里手动修改编译配置，把默认引擎改成 XeLaTeX。具体配置如下：在settings.json中加入：\njson\n"latex-workshop.latex.recipes": [\n {\n "name": "xelatex",\n "tools": ["xelatex"]\n }\n],\n"latex-workshop.latex.tools": [\n {\n "name": "xelatex",\n "command": "xelatex",\n "args": ["-synctex=1", "-interaction=nonstopmode", "-file-line-error", "%DOC%"]\n }\n]\n\n这样配置之后，每次按下编译快捷键都会调用 XeLaTeX，中文字体支持和编译结果都稳定很多。\nVS Code 还有一个加分项：它的 LaTeX Workshop 插件自带正向同步功能，在.tex源码里点一下命令，再按Ctrl+Cmd+J（macOS），PDF 预览会自动跳到对应位置。反过来，在 PDF 里点击也可以跳回源码，这对修改长文档非常友好。
3.3 Overleaf 在线编辑器：零配置的备选方案
如果你不想在本地折腾环境，或者偶尔需要和导师、同事协作编辑同一个文档，Overleaf 是一个很值得推荐的备选方案。它是网页版的 LaTeX 编辑器，不需要安装任何东西，注册完账号就能在线编辑和编译，默认支持 XeLaTeX，也有中文模板。\nOverleaf 的优势是零配置、跨平台、天然支持多人协作，实时同步功能甩本地编辑几条街。缺点是免费版编译耗时较长，高峰期排队严重，而且所有文件都在云端，有些人会担心数据安全。\n我的建议是：本地安装 TeX Live + VS Code 作为主力，Overleaf 作为应急方案和协作工具。尤其是投期刊时，很多出版社提供了 Overleaf 模板，直接在网页上改改提交，比本地折腾方便得多。
4. 安装后的必做检查与常用命令速查
4.1 三条命令验证安装是否真正成功
安装完成不等于万事大吉，我见过太多人装完直接开写，结果编译时报错才发现环境变量没配好。这里分享三个验证命令，建议装完顺手检查一遍。
第一条是latex --version，输出中应该包含 TeX Live 2022 字样和版本日期。如果提示“command not found”，说明 PATH 没配好。
第二条是xelatex --version，确认 XeLaTeX 引擎存在，这是中文排版的主力引擎。
第三条是kpsewhich ctex.cls，如果返回了 ctex.cls 的文件路径，说明 ctex 宏包已经就位；如果没有任何输出，说明完整版安装有问题，或者当前工作目录有问题。
这三条命令分别在终端里执行，全部通过后，你的 LaTeX 工具链才算真正可用。我还习惯顺手跑一个最小示例：新建一个test.tex，写入下面内容，用 XeLaTeX 编译一次。\nlatex\n\\documentclass{article}\n\\usepackage{ctex}\n\\begin{document}\n你好，LaTeX！\n\\end{document}\n\n编译成功生成 PDF 并正确显示中文，就是最好的验证。如果这一步报错，建议直接看第 5 节的问题排查。
4.2 常用编译命令与宏包管理命令
装好之后你会频繁用到这些命令，先熟悉它们，能省不少查资料的功夫。
编译命令：xelatex test.tex是最常用的一条，它会生成 PDF、aux、log 和 synctex 文件。编译带交叉引用的长文档需要跑两遍甚至三遍：第一遍生成引用信息，第二遍解析引用，第三遍彻底稳定。latexmk命令能自动判断需要跑几遍，latexmk -xelatex test.tex是推荐用法。\n宏包管理命令是tlmgr，比如tlmgr update --all更新所有宏包，tlmgr install 包名安装缺失宏包。但 Windows 用户要小心：TeX Live 安装完成后，tlmgr默认可能没有配好镜像源，更新时会很慢或失败。建议用tlmgr option repository 国内镜像地址把源切到可用镜像，这个操作细节后面会细讲。
4.3 换行符、图片插入、表格换行等高频语法备忘
考虑到很多人是边写边查，这里列几个最常被搜索的语法点，配合安装教程一起看正好。
换行符：LaTeX 中一个换行符会被当空格处理，真正的换行需要空一行（分段），或者用\\手动换行。表格里换行更特殊，需要在单元格内用\makecell或p{宽度}列类型，这也是很多人搜“latex表格自动换行”时获得的标准答案。
图片插入：```latex \usepackage{graphicx} \begin{figure}[htbp] \centering \includegraphics[width=0.8\textwidth]{图片路径} \caption{图片标题} \label{fig:label} \end{figure}
图片路径支持相对路径和绝对路径，但建议把图片放在与 `.tex` 文件同级的 `figures` 目录下，用相对路径引用。 数学符号和公式：行内公式用 `$...$`，行间公式用 `\[...\]` 或 `equation` 环境。希腊字母对应关系就是 LaTeX 里的基础语法，比如 `\alpha` 是 α，`\beta` 是 β，`\infty` 是无穷大。 这些语法点平时不一定全用得上，但安装完之后先跑一遍最小的实际文档，比背语法清单更有用。 ## 5. 常见问题排查与避坑指南 ### 5.1 安装卡住、下载失败怎么办：换源方案详解 安装 TeX Live 时最常见的痛点是下载慢、中途卡住。原因很简单：默认服务器在国外，国内网络访问不稳定。解决方案是安装时直接指定国内镜像源，这能够大幅提升成功率和速度。\n在 install-tl 运行后的命令行交互界面中，输入 `O`（大写字母 O）进入高级配置选项，然后选择镜像源地址。推荐使用清华大学的镜像：`https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet/`，也可是阿里云镜像 `https://mirrors.aliyun.com/CTAN/systems/texlive/tlnet/`。输入地址后按回车确认，其余步骤保持不变。\n如果你已经装完了 TeX Live 才发现下载慢，也可以通过命令把 tlmgr 的仓库切换到镜像源：`tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet/`，这样后续更新宏包时也会走镜像，速度明显更快。\n这里有个细节要注意：2022 年的 TeX Live，官方文档中关于版本库的路径是 `.../systems/texlive/tlnet/`，但有时镜像站会有不同的目录组织方式。如果输入后报错提示找不到仓库，去镜像站上看一下实际的目录结构再改，通常就是去掉或加上 `tlnet` 这两级目录的区别。 ### 5.2 编译报错：怎么快速定位是哪里出了问题 新手最常见的编译报错场景是：写了一段代码，点编译，PDF 没生成，日志文件几百行，完全不知道错在哪。我提供一个三板斧定位法。\n第一板斧：看第一条 error。LaTeX 是顺序编译的，第一条 error 往往就是根源，后面的 error 大多是连锁反应，不用管。用编辑器直接搜 `!` 开头的行，通常真正的错误信息在那里。\n第二板斧：看行号。如果在编译命令中加了 `-file-line-error` 参数（LaTeX Workshop 默认已加），错误信息会明确提示哪个文件哪一行出错。回到源码对应位置，八成是缺了大括号、写错了命令名或者图片路径不对。\n第三板斧：如果是中文文档报错，优先怀疑编码问题和字体问题。现代 TeX Live 默认支持 UTF-8，但如果模板过期或者用了过时的 CJK 包，就可能报错。统一用 XeLaTeX 编译、保证文件保存为 UTF-8 编码，能规避 90% 的中文编译问题。\n如果日志确实太长看不懂，还可以把 `.log` 文件里的内容复制到搜索引擎里搜，几乎每个报错都有人踩过，直接搜错误原文往往比对着文档分析更快。 ### 5.3 环境变量问题与多版本共存经验 Windows 用户安装完 TeX Live，如果打开 cmd 输入 `xelatex` 还是提示“不是内部或外部命令”，可以按以下顺序排查：\n先确认安装目录下有 `xelatex.exe` 文件，如果不在默认目录，说明安装时改了安装路径；再去系统设置里查找“编辑系统环境变量”，看 PATH 是否有 `C:\texlive\2022\bin\windows`，如果没有就手动添加；添加完成后一定要新开一个终端窗口再试，环境变量的修改不会对已打开的窗口生效。\nmacOS 用户的问题通常出在安装 MacTeX 后终端不能直接使用 xelatex，因为 MacTeX 的二进制路径可能没自动加入 `.zshrc`。在终端里执行 `export PATH=/usr/local/texlive/2022/bin/universal-darwin:$PATH` 可以临时解决，永久方案是把这行追加到用户的 `.zshrc` 文件中。\n还有一个高级问题：同一台机器上装了多个 TeX Live 版本，怎么确保用的是 2022 版？用 `which xelatex` 查看当前生效路径，如果不是你想要的版本，调整 PATH 的顺序，把目标版本的 bin 目录放到前面即可。完全不用的旧版本可以整个目录删掉，但不建议手动删，容易留下环境变量残留。有洁癖的话可以重装系统后再只装一个版本，一劳永逸。 ### 5.4 宏包缺失与字体问题 完整版安装很少遇到宏包缺失，但如果装了精简版或用了旧模板，就可能遇到 `! LaTeX Error: File 'xxx.sty' not found`。解决办法就是找到宏包名并安装，比如缺少 `algorithm2e.sty`，运行 `tlmgr install algorithm2e`。\n字体问题则多见于中文用户：XeLaTeX 编译时提示“font not found”。解决方案有两个：第一，使用 ctex 宏包并指定字体，比如 `\usepackage[fontset=windows]{ctex}`；第二，直接用系统字体，`\setCJKmainfont{微软雅黑}` 或 `\setCJKmainfont{SimSun}`。具体字体名称取决于你的操作系统，macOS 上则是 `Songti SC` 或 `PingFang SC`。\n一个容易忽略的细节：如果字体文件名带空格，命令里要用花括号包住完整字体名。另外，别随便下载网上流传的所谓“LaTeX 字体包”覆盖系统文件，很大概率会把原本正常的字体配置搞乱。 ## 6. 从安装到第一份文档：完整跑通示例 ### 6.1 一个包含标题、公式、图片、引用的最小示例 理论讲得再多，不如亲手跑一遍。这里我准备了一个最小但完整的示例文档，你把它复制到本地，编译成功就能看到 LaTeX 的主要特性。\n```latex\n\\documentclass[UTF8]{ctexart}\n\\usepackage{graphicx}\n\\usepackage{amsmath}\n\\title{我的第一份LaTeX文档}\n\\author{你的名字}\n\\date{\\today}\n\\begin{document}\n\\maketitle\n\\section{引言}\n这是一份测试文档，用于验证LaTeX安装是否成功。\n\\section{公式示例}\n质能方程可以用公式表示为 $E = mc^2$，行间公式如下：\n\\begin{equation}\n \\int_0^\\infty e^{-x^2}\\,dx = \\frac{\\sqrt{\\pi}}{2}\n\\end{equation}\n\\section{图片示例}\n图片插入效果见图~\\ref{fig:demo}。\n\\begin{figure}[htbp]\n \\centering\n \\includegraphics[width=0.6\\textwidth]{example-image}\n \\caption{示例图片}\n \\label{fig:demo}\n\\end{figure}\n\\end{document}\n```\n这个文档涵盖了一篇论文最常见的元素：标题、作者、日期、章节、行内公式、行间公式、图片插入和交叉引用。如果你能成功编译出 PDF，说明工具链已经完全就绪。\n注意最后用 `xelatex` 编译两遍再查看效果。第一遍生成引用关系，第二遍交叉引用和页码才会正确显示，这也是新手最容易忽略的。 ### 6.2 如何判断 PDF 输出是否正常 打开编译生成的 PDF，重点检查三部分。第一，中文字体是否正确渲染，如果出现方块或乱码，点击 PDF 中的文字看看是否能选中，能选中说明只是显示问题，不能选中则说明引擎没走 XeLaTeX。第二，公式编号是否出现在右侧，编号是 LaTeX 自动生成的，如果你改了顺序它会自动调整，这本身就是正常的。第三，图片是否居中显示、是否按缩放比例适配版心。\n如果 PDF 在这些方面都正常，你的安装和配置就算彻底过关了。之后就是语法学习和模板套用的时间，相信你已经具备了自己探索的能力。 ### 6.3 写作流程建议：先本地后在线、先模板后自由 最后分享一个我自己的写作习惯。每开始一个新项目，我会先确认项目有没有官方模板：期刊投稿看出版社官网，毕业论文看学校教务处。用官方模板启动，比从空白文档开始省力很多，版式也合规。模板下载后，先不改内容，直接编译一遍，确认模板本身能通过编译，再往里面填内容，这一步能避免“模板有问题还是我写错了”的纠结。\n等模板跑通了，再用 VS Code 打开，按照第 3 节的方式配置好 XeLaTeX，就可以正常写作了。需要多人协作时，把 `.tex` 源码同步到 Overleaf 或者用 Overleaf 直接模板化启动，效率更高。这套“本地为主、在线协作”的流程，是我和实验室同门验证过许多次的经验，每一步都有其必要性。 ## 7. 最后的经验之谈 安装 LaTeX 这件事，说难不难，说简单也不简单。难的是它不像普通软件那样双击下一步就能用，需要理解一点点工具链的概念；不简单的是你有没有耐心按部就班地做完检查，而不是装完就急着写文档、出了错又不知道从哪排查。\n我自己踩过最深的坑，就是第一次装的时候图省事选了精简版，结果写论文用到 `algorithm2e` 宏包时彻底卡住，安装宏包又排错了镜像源，折腾了一个晚上。后来重装完整版，所有问题一次解决。从那以后，我给所有人的建议都一样：老老实实上官网、装完整版、配置 XeLaTeX，这三个动作做到位，后面能省下大量时间。\n如果你在安装过程中遇到的问题这篇文章没有覆盖到，我建议你先把报错信息原样复制到搜索框里查一下，大部分常见坑都有无数人分享过解决方案。装好之后，也别忘了定期用 `tlmgr update --all` 更新宏包，保持环境健康。LaTeX 这东西，一旦跑通了，之后就会越来越顺手，希望这篇教程能帮你顺利跨过第一道门槛。
