前几天帮一位研究生同学装 LaTeX，他第一句话是：“这个软件到底从哪里下啊？我看网上有 TeX Live、MacTeX、MiKTeX、TeXstudio 一堆名字，整个人都晕了。”我意识到一个很重要的问题：大部分所谓“安装教程”，默认读者已经搞懂了 LaTeX 生态里的各种概念，而真正的初学者恰恰卡在概念这一关。所以这篇“全网最细 LaTeX 安装教程（2026 版）”我尽量写成实打实的保姆级流程：从发行版怎么选、Windows/macOS/Linux 分别怎么装，到 VS Code 怎么写配置，再到第一个 PDF 怎么出来，最后附上我在帮无数人排错过程中遇到的高频问题。目标就一个——你照着做，今天之内一定能出 PDF。
先把思路理清楚。LaTeX 的安装不是“装一个软件”那么单薄，它其实包含三件事：第一，安装编译系统和宏包（也就是发行版）；第二，准备一个写代码的编辑器，并让它能调用编译；第三，搞清楚文档结构和编译流程。三步都通了，后面你用 LaTeX 写论文、写简历、写实验报告，基本就是复制粘贴模板再改内容的事。
1. 动手之前先搞清楚这几件事：LaTeX、发行版和编辑器的关系
1.1 LaTeX 不是“一个软件”，它是一套排版语言
1.1 LaTeX 不是“一个软件”，它是一套排版语言
很多人搜“latex 下载”，搜到一堆名字后更迷茫了，问题就出在没搞清这层关系。LaTeX 本质上是一套排版标记语言，你写一个普通文本文件，里面用各种命令描述“这是标题”“这是公式”“这是图片”，然后让编译器把这个文本文件渲染成漂亮的 PDF。这个过程很像写 HTML 然后用浏览器渲染，也像写 C 代码然后编译成程序。
在这个体系里，TeX 是最底层的排版引擎，LaTeX 是在 TeX 之上封装出来的宏语言，把我们常用的章节、公式、表格、目录、引用都做成了现成命令。TeX Live 则是“发行版”，相当于 Java 世界的 JDK，它把编译器（比如 xelatex、pdflatex）、几百个宏包、字体文件、文档工具打包在一起供你安装。编辑器则是你写 .tex 文件的地方，用记事本也能写，用 VS Code 写起来更舒服。
理解这个结构后，很多错误信息你就能看懂了。比如报错“ctex.sty not found”，意思是宏包缺失，不是你的编辑器坏了；报错“xelatex: command not found”，意思是发行版没装好或没进 PATH，不是你代码写错了。
1.2 选哪个发行版：主流方案对比
发行版是整套环境的地基，选不对后面全是坑。目前主流有三个：
| 平台 | 首选方案 | 理由 | 安装包 |
|---|---|---|---|
| Windows | TeX Live 官方版 | 宏包最全、社区默认标准、跨平台一致 | install-tl-windows.exe 或 zip 包 |
| macOS | MacTeX | 自带 TeX Live 全家桶加 GUI 工具，一键安装 | MacTeX.pkg |
| Linux | texlive-full 或 texlive-most | 系统源直接装，维护更新方便 | apt / pacman / dnf 包 |
有些人会推荐 MiKTeX，优点是“按需安装宏包”，装哪个包临时下载哪个，初装体积小。但它的缺点是：团队协作时别人机器上全量宏包能编译成功，你的 MiKTeX 却可能现场联网下载宏包，导致“我这边是好的，你那边报错”的窘境。个人随便用用没问题，但如果你要跟导师、同学交流模板，TeX Live 仍然是 2026 年最稳的选择，多数期刊模板和课程作业模板默认就是围绕它来的。
1.3 2026 版推荐的完整安装路线图
不废话，直接给路线：下载 TeX Live 2026（含中文宏包 ctex、图片宏包 graphicx、数学宏包 amsmath 等）→ 安装 VS Code → 安装 LaTeX Workshop 插件 → 配置 xelatex 编译 → 新建 .tex 文件 → 一键编译 → 预览 PDF。
整个流程里，最费时间的其实是 TeX Live 下载和安装这一步，后面都很快。下面每个环节我都按可复现的方式写。
2. 安装主力软件：Windows/macOS/Linux 平台的 TeX Live 实测流程
2.1 Windows：用官方安装器，选 full 方案最省心
2.1 Windows：用官方安装器，选 full 方案最省心
Windows 上我建议直接去 TeX Live 官网或国内镜像站下载install-tl-windows.exe
。2026 版依然提供图形化安装界面，过程不算复杂，但有三个关键点值得注意。
第一，选择安装源。默认从 CTAN 官方源下载，在大陆网络环境下速度可能很慢，强烈建议换成清华 TUNA 镜像或中科大镜像。在安装界面里找到“镜像站点”或TEXLIVE_INSTALL_TLPDB_OPTIONS之类的选择项，把下载源改成https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet/
。别小看这一步，镜像源和官方源的速度差距经常是几十倍。
第二，选择安装方案（scheme）。如果你硬盘空间允许，直接选full scheme
，也就是完整方案，所有宏包一次装全。虽然占用可能到 7-8GB，但之后你写任何模板都不太可能因为缺宏包而编译失败。对初学者来说，这个代价非常值。别选那些精简方案，省了几 GB 空间，换来的是无穷无尽的“File xxx.sty not found”。
第三，安装过程可能要 30-60 分钟，界面看起来像卡住了，日志在滚动但进度条不动，这是正常的。不要中途关掉。装完后，重新打开一个命令行，输入xelatex -v
，如果能看到版本号，说明安装成功。
2.2 macOS：MacTeX 一键安装包最稳
macOS 用户首选 MacTeX。它不是一个和 TeX Live 并列的独立发行版，而是把 TeX Live 以及一些 mac 上的 GUI 工具打包到一起的分发包。下载MacTeX.pkg
，双击安装，默认一路下一步就可以了。
安装完成后，多数情况下终端里就能直接使用xelatex
命令。如果提示找不到命令，一般是因为 shell 没有重新加载配置。你可以运行：
eval "$(/usr/libexec/path_helper)"或者打开一个新的终端窗口再试。如果还是没有，运行sudo tlmgr path add
把 TeX 目录加进 PATH，然后重启终端。
在 Apple Silicon（M 系列芯片）机器上，MacTeX 现在没有兼容性问题，放心装。唯一的提醒是安装包体积在 5-6GB，磁盘紧张的话提前清理空间。如果你只是想临时写个文档不想装全家桶，也可以考虑 BasicTeX，但我个人不推荐初学者用，因为缺失的宏包实在太多，后续排查太心力交瘁。
2.3 Linux：命令行安装，注意区分基础包和中文字体包
Linux 的好处是发行版基本都进了软件源，一条命令能省去很多事。以最常见的发行版为例：
Debian / Ubuntu：
sudo apt update sudo apt install texlive-full texlive-lang-chineseArch Linux：
sudo pacman -S texlive-most texlive-lang-chinese texlive-latexextraFedora：
sudo dnf install texlive-scheme-full texlive-lang-chinese很多人在 Linux 上装完基础包不装texlive-lang-chinese
，结果中文文档一编译就报字体或编码错误。所以安装时一定记得把中文支持包带上。
Linux 装系统包的好处是后续用系统的包管理器就能统一升级，坏处是系统源里的 TeX Live 版本可能比官网发布慢一些。如果你非常在意版本新度，可以跟 Windows 一样下载官方install-tl
脚本安装到用户目录，但操作复杂度会高一些。我的看法是，日常写论文用系统源版本完全够，没必要追新。
2.4 安装完成后的验证命令
装完别急着开写，先验证一下环境。在终端里执行：
xelatex -v能输出版本号说明编译器没问题。再执行：
kpsewhich ctex.sty如果能打印出一个.sty
文件的路径，说明中文支持宏包已经就位。这个验证非常关键，很多教程压根不提，导致你后面写了中文模板一编译就报错，还不知道是哪里缺东西。
3. 配置 VS Code 写作环境：LaTeX Workshop 与 xelatex 中文方案
3.1 为什么选 VS Code，而不是 TeXstudio
3.1 为什么选 VS Code，而不是 TeXstudio
老教程很喜欢推荐 TeXstudio，它确实开箱即用，但界面布局偏老旧，跨平台一致性一般。相比之下，VS Code 加上 LaTeX Workshop 插件在 2026 年已经非常稳定，而且 VS Code 是很多程序员本来就在用的编辑器，熟悉成本几乎为零。你只需要装一个扩展，编译、预览、清理、正向搜索、反向搜索全部内置，还能跟 Git 配合管理论文版本。如果你平时用 PyCharm，也可以装 TeXiFy IDEA 插件，但功能完整度和社区资料不如 LaTeX Workshop，愿意折腾的人可以试，求稳的话还是 VS Code。
3.2 安装 LaTeX Workshop 扩展
打开 VS Code，在扩展市场搜索LaTeX Workshop，认准作者是 James Yu 的那个，点击安装。这个插件会把.tex
文件识别成 LaTeX 类型，并且在左侧边栏生成一个 TeX 面板，编译按钮和清理按钮都在那里。
安装完扩展后，大概率还有一个隐藏坑：VS Code 默认的终端编码或扩展调用的命令可能不是 xelatex。所以下面这步配置很重要。
3.3 核心配置：settings.json 里写什么
拿到一个干净的 VS Code，按Ctrl+Shift+P，输入Preferences: Open User Settings (JSON)，打开settings.json
。把下面这段配置粘贴进去：
{ "latex-workshop.latex.recipes": [ { "name": "xelatex", "tools": ["xelatex"] } ], "latex-workshop.latex.tools": [ { "name": "xelatex", "command": "xelatex", "args": [ "-synctex=1", "-interaction=nonstopmode", "-file-line-error", "%DOC%" ] } ], "latex-workshop.view.pdf.viewer": "tab" }这里解释一下为什么这样写。recipes是编译方案列表，LaTeX Workshop 可能默认先用pdflatex编译，但我们处理中文必须用xelatex，所以自定义方案里只放一个 xelatex。tools定义具体命令和参数，其中-synctex=1是为了启用源代码和 PDF 之间的双向跳转，-interaction=nonstopmode让编译器遇到错误时不要停下来等交互，而是直接输出日志，-file-line-error让报错信息带上具体行号，%DOC%是当前正在编辑的文件名。view.pdf.viewer设为tab
，是在 VS Code 内部标签页里预览 PDF，省得切窗口。
3.4 中文字体支持的两把钥匙
第一把钥匙是编译引擎用 xelatex。xelatex 对 Unicode 和系统字体有原生支持，处理中文非常友好。为什么不用 pdflatex？因为 pdflatex 默认编码不是 UTF-8，处理中文要配置字体映射，新手几乎必踩坑，别跟它较劲。
第二把钥匙是文档本身装载中文宏包。你可以用\documentclass{ctexart}
，也可以这样：
\documentclass{article} \usepackage[UTF8]{ctex}两种方式都行。ctexart文档类更省事，直接把中文支持整合进文档类设计里；article配ctex宏包则更灵活。对于论文写作，我推荐直接用ctexart
。
3.5 顺手加几个省心的辅助设置
如果不想每次编译后留下大量.aux、.log、.out临时文件，可以在settings.json
里加一行：
"latex-workshop.latex.autoClean.run": "onFailed"还可以设置保存即编译，这样Ctrl+S
存完文章，PDF 就自动刷新：
"latex-workshop.latex.autoBuild.run": "onSave"快捷键方面，Ctrl+Alt+B是编译，Ctrl+Alt+V是预览，编译出来错误时Ctrl+Alt+J
会跳到报错位置。记熟这几个键，写论文效率提升明显。
4. 第一次正式编译：从新建项目文件夹到看完第一份 PDF
4.1 项目目录结构为什么重要
4.1 项目目录结构为什么重要
很多人直接在一个满是下载文件的目录里新建test.tex就开始写，这在中后期是个隐患。LaTeX 项目最好独立建一个文件夹，比如thesis/
，里面分门别类：
thesis/ ├─ main.tex ├─ figures/ │ ├─ experiment.png │ └─ result.pdf ├─ ref.bib └─ sections/ ├─ intro.tex └─ method.tex把图片放在figures/子文件夹、章节内容拆到sections/
里，是成熟项目的通用做法。这样做的好处是日志报错时能快速定位，图片路径也不会乱。后面写长论文，你会有几百个图片和几十个章节，没有清晰目录结构会想哭。
4.2 最小但完整的 .tex 文件
用 VS Code 打开thesis/文件夹，新建一个main.tex
，把下面的内容复制进去：
\documentclass[UTF8]{ctexart} \usepackage{graphicx} \usepackage{amsmath, amssymb} \title{我的第一篇 LaTeX 文档} \author{你的名字} \date{\today} \begin{document} \maketitle \section{引言} 你好，LaTeX！这一行是中文测试。公式示例： \begin{equation} E = mc^2 \end{equation} 图片示例： \begin{figure}[htbp] \centering \includegraphics[width=0.6\linewidth]{figures/example.png} \caption{这是示例图片} \end{figure} \end{document}\documentclass[UTF8]{ctexart}指定文章使用中文文档类，UTF-8 编码；graphicx用来插图；amsmath和amssymb是数学排版基础宏包；\maketitle生成标题和作者信息。如果你还没有图片，可以先在figures/
里放任意一张 PNG。
4.3 编译到底按哪个按钮
点击 VS Code 左侧栏的 TeX 图标，打开最上方的Build LaTeX project，选择xelatex。也可以直接按Ctrl+Alt+B
。第一次编译可能要等十几秒，中间终端会滚动输出大量日志。等到侧边栏出现 PDF 预览，说明编译成功。
这个“按一下按钮”的过程，在命令行里实际执行的是：
xelatex -synctex=1 -interaction=nonstopmode -file-line-error main.tex理解这条命令有好处：当你离开 VS Code，需要在服务器上、或者用脚本编译的时候，你不会对着终端发怵。
4.4 双栏排版怎么设置
很多期刊和毕业论文要求双栏排版，这在 LaTeX 里是一个文档类选项的事：
\documentclass[UTF8, twocolumn]{ctexart}加上twocolumn后，正文自动变成双栏。如果只是局部双栏，可以用multicols
环境：
\usepackage{multicol} \begin{multicols}{2} % 这部分文字显示为双栏 \end{multicols}双栏模式下，单栏图片宽度要用0.8\linewidth
这种相对宽度，不要写死成像素值，否则排版会很难看。
4.5 后续马上会用到的一批常用宏包
我不建议你一次装一堆看不懂的宏包，但有那么几个几乎是刚需，记住它们的用途：
| 宏包 | 作用 |
|---|---|
| ctex / ctexart | 中文排版支持 |
| graphicx | 插图功能 |
| amsmath, amssymb | 数学公式与数学符号 |
| geometry | 自定义页面边距 |
| hyperref | 生成 PDF 书签和超链接 |
| booktabs | 专业表格横线 |
| tabularx | 表格自动换行 |
用到谁才在高处加\usepackage{}
，这是最自然的做法。
5. 新手最容易踩的坑：图片、表格换行、参考文献与双栏排版排查
这一节是你以后回来看得最多的部分。下面的问题全部来自我真实经历或帮别人排查过的场景，尤其那些在热搜词里反复出现的问题，比如反斜杠怎么打、图片插不上、表格不换行、两篇参考文献格式、双栏图片跑飞等。
5.1 反斜杠（右斜线）怎么打
LaTeX 每条命令都是以反斜杠\开头的，比如\alpha、\section
。但很多新手在中文输入法状态下打这个键，发现打出来的是顿号“、”或者其他符号，于是问“latex 右斜线怎么打”。
这个问题的根源是输入法标点状态。Windows 下中文拼音输入法开启时，键盘上的反斜杠键会被映射成中文标点；你需要先切换到英文输入状态，再按反斜杠键。反斜杠键一般在 Backspace 键左侧或 Enter 键上方，不同键盘布局位置略有差异。苹果键盘上通常在 return 键旁边。如果你实在找不到实体键，可以复制一个已有的\
应急，但长期看还是要记住那个键的位置。
如果你是想在 LaTeX 生成的文档正文里显示一个反斜杠字符，直接输入\会被当成命令标记，需要用命令\textbackslash
来输出。
5.2 图片插入失败的完整排查链
图片插不进去是搜索量极高的问题，最典型报错是：
File 'figure.png' not found.按下面对照，十有八九能解决。先确认是否在导言区写了\usepackage{graphicx}；再看路径是否正确，如果图片在figures/子目录，\includegraphics要写成{figures/example.png}
；随后检查文件名大小写，Windows 不敏感，macOS 和 Linux 是严格区分大小写的；最后确认图片格式，用 xelatex 编译时建议统一用 PNG、JPG 或 PDF 格式，尽量不要用奇怪格式。
还有一种情况是图片太大，没有报错但排版溢出页面。用[width=0.8\linewidth]
这种选项把宽度控制成页面宽度比例，而不是填一个绝对像素值。
5.3 表格自动换行的处理办法
表格单元格文字一长就溢出，这是 LaTeX 入门时最容易懵的问题。解决思路不是调节字体大小，而是改变列类型。
普通表格列类型c、l、r是不换行的，文字多长就往一侧拉多长。要让表格自动换行，改用p{宽度}
类型：
\begin{tabular}{p{3cm} p{4cm} p{3cm}} 一段很长的文字会自动换行 & 另一列 & 第三列 \end{tabular}如果想让表格整体宽度自动适配文本区域，推荐tabularx宏包，X
列类型会自适应平分剩余宽度：
\usepackage{tabularx} \begin{tabularx}{\linewidth}{|X|X|X|} \hline 一段很长的文字在这里自动换行 & 第二列 & 第三列 \\ \hline \end{tabularx}这是我实测下来最可靠的一套方案。注意tabularx环境第一参数是总宽度，\linewidth
表示当前栏宽，非常方便。
5.4 一个位置引用两篇参考文献的格式
写论文时常要在一个括号里引用两篇文献，比如“已有研究[1,2]”。新手常犯的错误是写成\cite{a}\cite{b}
，结果得到 [1][2] 两个括号，排版很难看。正确写法是：
\cite{smith2020, jones2019}如果是作者-年份制，用natbib
宏包：
\usepackage[round]{natbib} \citep{smith2020, jones2019}这样会输出“（Smith, 2020; Jones, 2019）”这种格式。用 BibLaTeX 也有对应的\parencite{key1,key2}。重点是：多个 key 用英文逗号分隔，写在一个命令里，而不是写多个\cite
命令。
5.5 双栏排版中图片位置不对怎么办
双栏论文里图片“跑偏”是另一个高频问题。原因在于 LaTeX 默认在文本流中寻找最适合放置浮动体的位置。如果你想要图片只占当前栏宽度，保持普通figure环境即可；但如果你想把图片拉通到整个跨栏宽度，就要把figure环境写成figure*
：
\begin{figure*}[htbp] \centering \includegraphics[width=0.9\linewidth]{figures/big.png} \caption{跨双栏的大图} \end{figure*}如果图片位置总跑到文章最后，多半是位置参数的问题。[htbp]分别代表“此处、顶部、底部、独立页”，但 LaTeX 只把它当建议而不是命令。你可以加载float宏包，使用[H]
强制把图片放在当前位置：
\usepackage{float} \begin{figure}[H] ... \end{figure}强制位置会影响 LaTeX 的自动排版质量，所以我的建议是先接受[htbp]，确实达不到要求再用[H]
。
5.6 数学符号和特殊符号速查
LaTeX 写公式是绝对优势，但符号记不全是初期的拦路虎。常用的有：希腊字母\alpha、\beta、\gamma、\theta；求和\sum、积分\int、极限\lim；上下标x^2、x_i等。所有数学符号都要在数学环境里使用，比如$...$或者equation
环境，否则会报错或显示奇怪。
特殊字符方面，%、&、#、_
这些在 LaTeX 里有特殊含义，要在正文中显示它们，必须加反斜杠：
\% \& \# \_还有一个搜索热度不低的“左小括号 latex 代码”：普通括号(和)在 LaTeX 里直接输入即可。很多人是想在公式里输入大括号，但大括号{}在 LaTeX 里是分组的语法符号，不会显示出来，要显示花括号得用\{和\}
。
5.7 Word 里的 LaTeX 公式验证用不了？
有人搜索“Word 的 latex 无法正常显示”，这多半是把 Word 的“公式-LaTeX 语法输入”当成完整 LaTeX 了。Word 的公式编辑器确实支持类似 LaTeX 的输入，比如输入\sqrt后按空格会变成根号，但它并不是完整 LaTeX 系统，不支持宏包、不支持自定义命令，输入格式稍微不对就不识别。我的态度很直接：如果你已经跟着本文搭好了 VS Code + TeX Live 环境，写公式就去.tex
文件里写，Word 那套当备胎可以，当主力会让你气得想砸电脑。
5.8 安装中断、卡住或报错怎么处理
TeX Live 安装过程容易看起来像“卡死了”，其实它还在跑。如果真正中断了，比如断电、关错窗口，不要慌，重新运行安装器，它一般能继续或从镜像重新校验。如果是下载慢，回到第 2 节换成国内镜像站，这是最有效的提速手段。如果是权限问题（macOS/Linux 装到系统目录时常见），检查你有没有用管理员权限，Windows 则检查杀毒软件是否拦截了安装器。装到一半被杀毒软件清掉的案例，我见过挺多次了。
6. 装完后的建议：怎么从“能编译”走向“会排版”
环境装完只是起点，真正能帮你省时间的是一套正确的使用习惯。我根据自己的长期使用经验，给几条实在的建议。
第一，先拿模板练手，不要从零学语法。很多学校、期刊都提供官方 LaTeX 模板，你下载下来，替换里面的标题、作者、正文内容，编译一次能过，就说明环境和模板都没毛病。这个过程比背语法快得多，也能让你建立信心。
第二，编译报错别只看最后一行。LaTeX 的报错日志很长，真正的问题往往在最早出现的那个!
开头的地方。养成习惯，报错后先看代码里对应行的内容，再查缺什么宏包或哪个括号没闭合。我处理最多的三类问题就是宏包缺失、文件名写错、花括号不配对，这三类占了新手排错总量的八成以上。
第三，用好代码折叠和目录。VS Code 里左侧大纲能显示所有章节结构，长论文里跳转特别方便。每个section、subsection
前面多空行，视觉上也不容易迷失。
第四，尽快接触 Git。论文改来改去是常态，用 Git 管理每次修改，随时回滚，比“新最终版2.doc”这种文件命名方式靠谱一万倍。这个不多展开，但建议起步就养成本地仓库习惯。
最后说一句掏心窝的话：LaTeX 的学习曲线确实比 Word 陡一点，但它带给你的回报长尾很长。一旦你过了安装和入门这道坎，后面再写论文、实验报告、简历、甚至技术文档，排版质量的稳定性和自动化程度，是 Word 没法比的。希望这份教程能帮你在第一步走顺一点。