LaTeX 安装教程：TeX Live 与 XeLaTeX 中文配置指南

很多人第一次装 LaTeX 的经历都不太愉快：下载几个 G 的安装包、等了一个多小时、打开编辑器一编译满屏红字，然后默默关掉去干别的。我在带新人做论文排版的时候，见过太多人卡在"装不上"这一步，甚至有人因此对 LaTeX 产生了心理阴影。其实这套工具的安装本身并不复杂，真正劝退人的是信息太散——有人推荐 TeX Live，有人推荐 MiKTeX，有人让你装 VS Code，有人让你用 TeXStudio，看了一圈反而更迷茫。这篇 LaTeX 安装教程想做的事情很直接：把 Windows、macOS、Linux 三个平台的安装路径给你捋成一条线，让你用最短的时间跑通第一份文档，并且知道后面遇到报错该往哪里找原因。

需要提前说清楚的是，LaTeX 的安装不是"装一个软件"这么简单，它是一整套工具链的搭建。你把这份 LaTeX 安装教程走完，会得到三样东西：一套能编译的发行版、一个顺手的编辑器、以及一份验证过能跑的中文文档模板。适合零基础完全没接触过的人，也适合装过但没装明白、想重新整理一遍环境的人。下面从我踩过的坑开始讲。

1. 装LaTeX之前先搞明白：为什么这件事比想象中容易翻车

1.1 LaTeX不是软件，而是一整套工具链

这是最容易被误解的地方。很多人以为 LaTeX 就像 Word 一样，下载一个安装包双击装完就能用，结果装完发现要么打不开，要么打开编译不了。原因在于 LaTeX 实际由三部分组成，缺一不可。

第一部分是发行版（Distribution），它提供真正干活的编译器（如 xelatex、pdflatex）和成千上万个宏包，TeX Live、MiKTeX、MacTeX 都属于这一类。第二部分是编辑器（Editor），就是你敲代码的地方，TeXStudio、VS Code、TeXworks 都算。第三部分是编译引擎（Engine），负责把 .tex 源码翻译成 PDF，常见的有 pdfLaTeX、XeLaTeX、LuaLaTeX。

打个比方，发行版是厨房里的食材仓库和灶台，编辑器是锅铲，编译引擎是火候。你只买一口锅是炒不出菜的。所以安装流程的正确顺序是：先装发行版打地基，再装编辑器，最后确认引擎能正常工作。

1.2 大多数人卡住的三个位置

根据我帮人远程排查的经验，翻车点高度集中在三处。

下载源选错。直接去官网下载，国内网络环境下速度可能只有几十 KB/s，一个完整包要下几个小时，中途断线还得重来。

安装模式乱选。选了最小化安装想省空间，结果写论文时发现缺algorithm2e、缺booktabs，一个个补装比一次装全还费时间。

编辑器装了却没配编译链。尤其是 VS Code，装完 LaTeX Workshop 扩展后默认配置在某些中文场景下会报错，新手看到报错不知道是环境问题还是代码问题。

1.3 一条能走通的路线图

为了让你少走弯路，这里给一条最稳妥的主线：Windows 用 TeX Live + TeXStudio，macOS 用 MacTeX + TeXStudio，Linux 直接用包管理器装 texlive-full 配任意编辑器。等你熟悉之后再换 VS Code 也不迟。

对新手的建议是：第一次安装，稳定压倒一切，不要追求"最轻量"或"最酷炫"，先把文档编出来，信心建立了再折腾。

2. TeX Live下载与安装：镜像、模式、路径的三个关键决策

2.1 下载环节：为什么建议走国内镜像站

TeX Live 官网是 tug.org，但直接从这里下载体验往往一般。国内有几家高校和企业提供的开源软件镜像站，比如清华 TUNA、中科大 USTC、阿里云、华为云，都同步了 TeX Live 的安装文件，速度能跑满带宽，这是最实际的差别。

需要区分两种下载物：一个是几十 MB 的网络安装器（install-tl-windows.exe），下载后边联网边安装；另一个是几个 GB 的ISO 镜像，下载完整包再离线安装。网络好的话用安装器更省事，网络不稳的话建议下 ISO，不然装到一半断网会很崩溃。

2.2 安装模式：full和basic到底选哪个

TeX Live 提供了几档安装方案，核心差异在于预装宏包的数量。

我的观点很明确：只要硬盘不是特别紧张，直接上 full。省下的那点空间，换来的是后面不会因为缺宏包而中断写作。你写论文时突然报"Filexxx.sty' not found"，那种打断思路的烦躁感，比多占几 G 空间难受多了。真要是装了 basic，也可以用tlmgr install 宏包名` 补装，无非是多一个步骤。

2.3 安装路径与权限的坑

安装路径记住两条：不要有中文，不要有空格。虽然新版本对中文路径的兼容性好了不少，但某些宏包和脚本对非 ASCII 路径仍然不友好，出问题时排查起来很麻烦。推荐直接用默认路径，比如C:\texlive\2024。

安装界面上有几个选项值得注意。"Install for all users"和"Install for one user"决定了安装目录和权限，个人电脑选哪个都行，多人共用的机器建议选 all users。最重要的是那个"Adjust search path"（添加环境变量）选项，一定要勾上，否则命令行敲tex会提示"不是内部或外部命令"，你还得手动去系统属性里配 PATH。

安装完成后别急着关，打开一个新的命令行窗口（重要，旧窗口读不到新环境变量），依次敲：

tex --version xelatex --version tlmgr --version

三条都有版本号输出，说明发行版这块地基打好了。

3. 编辑器怎么选：TeXStudio零配置与VS Code自定义两条路线

3.1 TeXStudio：装完即用的稳妥选择

TeXStudio 是新手最省心的选择，因为它和 TeX Live 的集成几乎不需要额外配置。装完之后打开，界面左侧是文件结构和大纲，中间是编辑区，右侧是内置的 PDF 预览，编译和查看一体，不用来回切窗口。

几个必调的地方。进入选项 - 设置 TeXStudio - 构建，把默认编译器改成 XeLaTeX，这是后面中文文档能正常编译的关键。另外可以顺手打开"自动保存"和"实时拼写检查"。编译快捷键默认是 F5，查看 PDF 是 F6，用几次就记住了。

TeXStudio 还有一个隐藏福利：它自带命令补全，你敲\beg会自动提示\begin{}，敲\frac会给出分数结构的模板。对记不住命令的新手来说，这个功能能极大降低上手门槛。

3.2 VS Code + LaTeX Workshop：适合已经习惯VS Code的人

如果你本来就在用 VS Code 写代码，那不用再单开一个 TeXStudio，装个LaTeX Workshop扩展就够了。但它的默认配置基于 latexmk 和 pdfLaTeX，中文文档直接编译容易报错，需要改配置。

在settings.json里加上自定义工具和编译链，核心思路是定义一条 XeLaTeX 的 recipe：

{ "latex-workshop.latex.tools": [ { "name": "xelatex", "command": "xelatex", "args": ["-synctex=1", "-interaction=nonstopmode", "-file-line-error", "%DOC%"] } ], "latex-workshop.latex.recipes": [ { "name": "xelatex", "tools": ["xelatex"] } ] }

这里几个参数的含义值得说明：-synctex=1开启正反向搜索，让你能点 PDF 跳到源码、点源码跳到 PDF；-interaction=nonstopmode让编译遇到小错误不中断，一口气跑完给出完整日志；-file-line-error让报错信息带上文件行号，定位问题快很多。这些参数在命令行直接编译时同样适用。

3.3 用三个命令确认安装是否成功

无论用哪个编辑器，环境是否健全都可以用命令行快速验证。新建一个test.tex，内容先写最简单的：

\documentclass{article} \begin{document} Hello LaTeX. \end{document}

然后在命令行进入该目录，执行xelatex test.tex。如果目录里多出一个test.pdf，编辑器能打开它，说明整条链路是通的。这一步确认之后再写中文，否则分不清是环境问题还是中文配置问题。

4. 让第一份中文文档编译成功：引擎、宏包与编码的配合

4.1 为什么中文文档要认准XeLaTeX

这是 LaTeX 新手最容易踩的坑，也是我当年卡最久的地方。中文能不能正常显示，取决于编译引擎和宏包的配合。

老的 pdfLaTeX 引擎设计之初并没有考虑中日韩文字，处理中文要靠 CJK 宏包加一堆字体映射配置，稍微复杂一点就乱码。而XeLaTeX 和 LuaLaTeX 原生支持 Unicode，能直接调用系统中已安装的字体，处理中文自然得多。所以单纯从中文排版的体验来说，XeLaTeX 是目前最省心的选择。记住一句话：中文文档，编译器选 XeLaTeX。

4.2 最小可用中文模板

把下面这段存成hello.tex，用 XeLaTeX 编译，就能看到一份完整的中文文档，带标题、作者和日期：

\documentclass[UTF8]{ctexart} \title{我的第一篇中文文档} \author{某同学} \date{\today} \begin{document} \maketitle 你好，世界。这是一段中文正文。 公式也可以正常显示：$E = mc^2$。 \end{document}

这里的关键是ctexart这个文档类，它由 ctex 宏包提供，会自动帮你处理中文字体、段落缩进、标点挤压这些细节。你也可以用\documentclass{article}再配\usepackage[UTF8]{ctex}，效果类似。ctex 会自动识别操作系统，Windows 找宋体黑体，Mac 找苹方宋体一类的字体，一般不需要手动指定。

4.3 辅助文件都在干什么

编译一次之后，你会发现目录里多了好几个文件，新手看到这些往往一头雾水，甚至误删导致出错。它们各自的职责是这样的：

经验是：不要在编译出错时无脑删文件。先看 .log，找到真正的报错，再去处理。删掉辅助文件重新编译有时候确实能解决交叉引用错乱的问题，但它治标不治本，而且会掩盖真正的错误。

5. 编译失败时怎么办：从.log文件倒推问题的排查链路

5.1 别慌，先看第一个Error

新手看到满屏红色报错信息，第一反应是从下往上看，或者只看最后一行。这是误区。TeX 的报错会连锁放大——第一个错误常常引发后面几十条连带错误。你要找的是日志里第一个以感叹号!开头的错误，那才是根因。

在 TeXStudio 里，下方会有"错误和警告"面板，双击某条错误能跳转到出错行。如果编辑器没给跳转，就打开 .log 文件，搜索第一个!，往下读两行通常有具体位置描述。

5.2 高频错误对照表

下面这张表是我这些年攒下来的高频报错，基本覆盖了新手会遇到的大部分情况。

举一个我反复遇到的例子：有人把_下划线直接写在正文里，比如"变量 a_b"，结果报Missing $ inserted。原因是下划线在 LaTeX 里是数学模式专用的下标符号，文本模式里要用\_转义。这类符号规则在写代码时很常见，记住就好。

5.3 一步步复现一次排查

假设你编译中文文档时，PDF 里的中文全部变成方块或者直接报错。排查链路是这样的：

第一步，确认引擎。打开编译设置，看当前用的是不是 XeLaTeX。如果是 pdfLaTeX，先换过来重新编译，八成问题就解决了。

第二步，如果换了引擎还不行，看 .log 里有没有fontspec相关的报错。如果是"字体找不到"，说明该字体系列在你的系统里没有安装，可以在模板里显式指定一个存在的字体。

第三步，检查文档编码。确保源文件保存为 UTF-8 编码，现代编辑器一般默认就是，但用某些老编辑器打开旧文件时可能变成 GBK，这会引发乱码。

按这个顺序走，中文相关的编译问题基本都能定位。

6. 装完后马上用得上的高频操作：图片、表格与公式

6.1 插入图片：graphicx与浮动体

插入图片要用graphicx宏包，最常用的写法如下：

\usepackage{graphicx} \begin{figure}[htbp] \centering \includegraphics[width=0.8\textwidth]{figure.png} \caption{这是一个示例图} \label{fig:demo} \end{figure}

[htbp]是浮动位置偏好，分别代表 here 当前位置、top 页顶、bottom 页底、page 单独一页。LaTeX 会在这几个位置里挑最合适的，不一定完全听你的，这是它自动排版的特点，不是 bug。想引用这张图，写"如图 \ref{fig:demo} 所示"，编译后会自动填上编号。

有个常见困惑：文字里写了图，但图跑到了下一页甚至更后面。这是浮动体的正常行为，除非用float宏包的[H]强制固定。我的建议是别跟它硬刚，接受图片自动浮动，反而排版更整齐。

6.2 表格自动换行：p列与tabularx

这是被问得最多的问题之一：表格里的文字一多就冲出边框，怎么让它自动换行。原因是普通tabular的列宽是按内容撑开的，不会主动折行。解决方案有两种。

第一种是给列指定固定宽度，用p{宽度}：

\begin{tabular}{|p{3cm}|p{6cm}|} \hline 项目 & 说明 \\ \hline 表格 & 这一列的文字超过宽度会自动换行，因为用了 p 列。 \\ \hline \end{tabular}

第二种是用tabularx宏包，让列宽自动分配，整体宽度对齐页宽，X列会自动换行：

\usepackage{tabularx} \begin{tabularx}{\textwidth}{|X|X|} \hline 左边 & 右边，两列会自动平分页面宽度并折行 \\ \hline \end{tabularx}

表格内容经常超过一页的话，可以考虑longtable宏包，它能跨页断行。这几个宏包按需选择，不用一次全上。

6.3 数学公式与符号的输入习惯

数学是 LaTeX 的看家本领。行内公式用一对$包起来，比如$a^2 + b^2 = c^2$；段间独立公式用\[ ... \]或者带编号的equation环境。建议一律引入amsmath宏包，它提供了大量排版工具，是数学排版的标配。

常用符号记几个高频的：分数\frac{a}{b}，求和\sum，积分\int，希腊字母\alpha \beta \gamma，上下标用^和_。多字母下标记得加大括号，写x_{ij}而不是x_ij，后者只会让i变成下标。

实在记不住符号命令，可以用一些在线符号表工具查，或者装编辑器的符号面板插件。写公式的核心习惯是：遇到不认识的符号先猜英文名，多数情况下拼对英文单词就能敲出来。

7. 环境搭好之后，怎么把这套流程固化下来

7.1 建一个自己的文档模板

环境装好之后，最有价值的动作是把能用的最小模板存下来。我的做法是建一个template文件夹，里面放一个配置好的.tex文件，开头已经包含了ctexart、graphicx、amsmath、tabularx这些高频宏包，正文里放几行示例。以后写新东西，复制这个文件夹改名就行，省去每次重新配环境的时间。

模板里还可以放一个.gitignore，把.aux、.log、.synctex.gz这类自动生成的文件排除掉，只保留源码和图片。这样用版本控制工具管理论文的时候，仓库不会塞满无意义的中间文件。

7.2 迁移到别的机器时要注意什么

换电脑的时候，如果新机器装的是完整版 TeX Live，那么把源码文件夹拷过去直接就能编译，不用担心宏包缺失。如果新机器上是精简版，就可能报缺宏包的错。所以团队协作时，最好在文档里注明所需的宏包和编译引擎，别人拿到不至于两眼一抹黑。

引擎选择也要统一。同一个项目，你本地用 XeLaTeX，队友用 pdfLaTeX 编译，出来的效果可能不一样。约定好统一用 XeLaTeX，能省掉很多"我这边好好的"这类扯皮。

7.3 什么时候该考虑在线方案

如果只是偶尔写一两个简单公式，不想折腾本地环境，也可以先用在线编辑器过渡一下，把语法和基本操作熟悉了，再回来装本地环境。本地环境的好处是离线可用、编译大文档速度快、宏包版本可控，长期写论文或者排版书籍，还是绕不开本地这套。

我个人实际用下来最顺手的组合，就是 TeX Live 完整版加一个编辑器，XeLaTeX 处理中文，整套环境装一次能用好几年。真正需要重新配置的时候，通常是升级 TeX Live 大版本或者换系统。把这份 LaTeX 安装教程里的验证步骤和排查表格存下来，日后遇到报错照着查，基本不会被困太久。