前几天帮一位研究生同学装 LaTeX他第一句话是“这个软件到底从哪里下啊我看网上有 TeX Live、MacTeX、MiKTeX、TeXstudio 一堆名字整个人都晕了。”我意识到一个很重要的问题大部分所谓“安装教程”默认读者已经搞懂了 LaTeX 生态里的各种概念而真正的初学者恰恰卡在概念这一关。所以这篇“全网最细 LaTeX 安装教程2026 版”我尽量写成实打实的保姆级流程从发行版怎么选、Windows/macOS/Linux 分别怎么装到 VS Code 怎么写配置再到第一个 PDF 怎么出来最后附上我在帮无数人排错过程中遇到的高频问题。目标就一个——你照着做今天之内一定能出 PDF。先把思路理清楚。LaTeX 的安装不是“装一个软件”那么单薄它其实包含三件事第一安装编译系统和宏包也就是发行版第二准备一个写代码的编辑器并让它能调用编译第三搞清楚文档结构和编译流程。三步都通了后面你用 LaTeX 写论文、写简历、写实验报告基本就是复制粘贴模板再改内容的事。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 选哪个发行版主流方案对比发行版是整套环境的地基选不对后面全是坑。目前主流有三个平台首选方案理由安装包WindowsTeX Live 官方版宏包最全、社区默认标准、跨平台一致install-tl-windows.exe 或 zip 包macOSMacTeX自带 TeX Live 全家桶加 GUI 工具一键安装MacTeX.pkgLinuxtexlive-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 方案最省心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 macOSMacTeX 一键安装包最稳macOS 用户首选 MacTeX。它不是一个和 TeX Live 并列的独立发行版而是把 TeX Live 以及一些 mac 上的 GUI 工具打包到一起的分发包。下载MacTeX.pkg双击安装默认一路下一步就可以了。安装完成后多数情况下终端里就能直接使用xelatex命令。如果提示找不到命令一般是因为 shell 没有重新加载配置。你可以运行eval $(/usr/libexec/path_helper)或者打开一个新的终端窗口再试。如果还是没有运行sudo tlmgr path add把 TeX 目录加进 PATH然后重启终端。在 Apple SiliconM 系列芯片机器上MacTeX 现在没有兼容性问题放心装。唯一的提醒是安装包体积在 5-6GB磁盘紧张的话提前清理空间。如果你只是想临时写个文档不想装全家桶也可以考虑 BasicTeX但我个人不推荐初学者用因为缺失的宏包实在太多后续排查太心力交瘁。2.3 Linux命令行安装注意区分基础包和中文字体包Linux 的好处是发行版基本都进了软件源一条命令能省去很多事。以最常见的发行版为例Debian / Ubuntusudo apt update sudo apt install texlive-full texlive-lang-chineseArch Linuxsudo pacman -S texlive-most texlive-lang-chinese texlive-latexextraFedorasudo 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老教程很喜欢推荐 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按CtrlShiftP输入Preferences: Open User Settings (JSON)打开settings.json。把下面这段配置粘贴进去{ latex-workshop.latex.recipes: [ { name: xelatex, tools: [xelatex] } ], latex-workshop.latex.tools: [ { name: xelatex, command: xelatex, args: [ -synctex1, -interactionnonstopmode, -file-line-error, %DOC% ] } ], latex-workshop.view.pdf.viewer: tab }这里解释一下为什么这样写。recipes是编译方案列表LaTeX Workshop 可能默认先用pdflatex编译但我们处理中文必须用xelatex所以自定义方案里只放一个 xelatex。tools定义具体命令和参数其中-synctex1是为了启用源代码和 PDF 之间的双向跳转-interactionnonstopmode让编译器遇到错误时不要停下来等交互而是直接输出日志-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还可以设置保存即编译这样CtrlS存完文章PDF 就自动刷新latex-workshop.latex.autoBuild.run: onSave快捷键方面CtrlAltB是编译CtrlAltV是预览编译出来错误时CtrlAltJ会跳到报错位置。记熟这几个键写论文效率提升明显。4. 第一次正式编译从新建项目文件夹到看完第一份 PDF4.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[width0.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。也可以直接按CtrlAltB。第一次编译可能要等十几秒中间终端会滚动输出大量日志。等到侧边栏出现 PDF 预览说明编译成功。这个“按一下按钮”的过程在命令行里实际执行的是xelatex -synctex1 -interactionnonstopmode -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 格式尽量不要用奇怪格式。还有一种情况是图片太大没有报错但排版溢出页面。用[width0.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[width0.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 没法比的。希望这份教程能帮你在第一步走顺一点。