用 LaTeX 写论文有多爽用 LaTeX 装环境就有多折腾。这篇教程想一次性把下载、安装、配置这条路走通我尽量把每一步都拆到最细包括镜像站怎么选、安装选项怎么勾、VS Code 怎么写配置、参考文献为什么编译两遍还不出来全给你讲明白。不管你用的是 Windows、macOS 还是 Linux跟着往下走基本都能一趟水搞定。1. 初识 LaTeX为什么要装一套完整的发行版1.1 LaTeX 和 Word 的本质区别很多人第一次接触 LaTeX是从导师丢过来一份模板开始的。你打开 .tex 文件看到满屏反斜杠和花括号第一反应是“这玩意跟 Word 差距也太大了吧”。确实Word 是“所见即所得”LaTeX 是“所想即所得”——你写的是一份带标记的纯文本编译之后才变成 PDF。这套逻辑的好处是你只管把内容写对排版这种体力活交给 TeX 引擎处理。公式、图表编号、交叉引用、参考文献全部自动维护写 10 页和写 100 页的论文工作量差别没那么大。但在用 LaTeX 之前你至少需要搞明白它不是一个软件而是一整套工具链。日常大家说的“安装 LaTeX”实际上是安装一个发行版Distribution。发行版里打包了 TeX 引擎比如 pdfTeX、XeTeX、LuaTeX、几百上千个宏包package、字体文件、文档工具以及一套完整的分发管理机制。没有发行版你连那行“Hello World”都编译不出来。1.2 安装前必须确认的三个前提装 LaTeX 之前我建议你先花五分钟确认三件事能省掉后面一半的折腾。第一你的操作系统是什么是 64 位还是 32 位。现在主流发行版基本都放弃 32 位支持了老电脑装起来会有点麻烦。2026 年了建议至少 Windows 10 以上、macOS 12 以上、Ubuntu 20.04 以上太老的系统先想办法升级系统再谈安装。第二你打算用在线编辑还是本地编辑。如果你只是想快速写一份带公式的作业直接用 Overleaf 注册个账号就能开工根本不需要本地环境。但如果你需要处理本地模板、配合 Git 管理论文版本、或者学校的保密要求不允许源码外传那还是老老实实配一套本地环境。这篇教程走的就是本地路线后面讲的镜像、发行版、编译器配置都是为本地写作服务的。第三你的电脑磁盘空间够不够。常见的 TeX Live 完整版装完要 7 到 10 个 GB中文化配置之后可能更多。如果空间紧张可以考虑只装基础版collection-basic或者用 MiKTeX 按需安装宏包的模式。这个选择直接影响到后面安装选项怎么勾先想清楚再动手。注意LaTeX 的安装过程虽然是图形界面但环境变量、路径、编译器选择这些概念逃不掉。对命令行完全陌生的朋友遇到问题先去搞清楚“当前打开的终端在哪个目录”这个基础概念排查起来会顺手很多。2. 发行版选型与镜像站下载这一步决定你后面顺不顺利2.1 TeX Live 与 MiKTeX 到底选哪个安装 LaTeX绝大多数人面对的选择题就是 TeX Live 还是 MiKTeX。这两个发行版不是互斥关系你可以全装但不建议。我的建议很简单Windows 用户如果追求省心选 TeX LivemacOS 用户选 MacTeX本质是 TeX Live 的 macOS 封装版Linux 用户直接用系统包管理器装 TeX Live。MiKTeX 适合那些不想一次下载几个 GB 安装包的人它有一个很聪明的机制编译文档的时候用到某个宏包临时去下载装完就能用不会提前占满磁盘。但 MiKTeX 有个小毛病就是“临时下载”这个机制在网络环境不稳定的情况下会把编译搞得很痛苦编译到一半卡在“正在安装宏包”的提示上很影响心情。相比之下TeX Live 把所有宏包一次性铺好编译的时候不联网也没事适合需要稳定环境的论文党。我个人的经验是你要是准备长期使用老老实实 TeX Live别贪省那几个 G。2009 年我第一次装 LaTeX 用的还是 CJK 那套老古董后来切到 TeX Live 就再也没换过。2.2 镜像站下载与安装包选择技巧官网下载 TeX Live 或者 MacTeX 当然没问题但对于国内用户官网速度经常慢到让人怀疑人生。更科学的做法是找高校镜像站。你去搜索“TeX Live 镜像”“tuna texlive”或者“aliyun texlive”能看到一大堆同步官方源的地址。用镜像站下载速度能快几十倍而且安装方式完全一样。这里说一个通用套路第一步打开镜像站网页比如清华 tuna 源的 texlive 目录你会看到一堆带日期的文件夹2026 版对应“2026”文件夹是最新内容里面有一个 install-tl-windows.exeWindows 图形安装向导或者 install-tl-unx.tar.gzLinux/macOS 用的命令行安装包。第二步下载前先确认自己网络环境支持 HTTPS如果访问不了换镜像站源阿里云、腾讯云也都有同步换一个就好。第三步下载之后不要急着双击先把杀毒软件对安装目录的实时监控暂时关一下。不是有毒是 TeX Live 安装时会释放大量文件有的杀软会把批量释放误判为异常行为导致装到一半失败。这类问题我在 Windows 上遇到过不只一次。2.3 Windows 平台安装全过程详解Windows 安装 TeX Live我推荐走 install-tl-windows.exe 这条图形化路线。双击打开后第一屏会让你选安装源位置、安装目录和 scheme安装方案。这里注意几个设置项安装目录默认是 C:\texlive\2026建议不要改到带中文或空格的路径下后面配置会麻烦。如果你不想占用 C 盘可以装到 D:\texlive\2026 这类英文路径。scheme 选择下拉框里有 full scheme、medium scheme、basic scheme 等。省心做法是直接选 full把所有宏包全装进去。如果你不想装全量也可以选 basic但后面缺宏包的时候需要自己用 tlmgr 补对新人不太友好。安装时长完整方案在机械硬盘上可能要 30 到 60 分钟SSD 上快一些10 到 20 分钟。别中途关掉这个安装过程确实体感比较“复古”。安装完成后安装程序通常会自动把 TeX Live 的相关目录加进系统 PATH。但有一种情况比较常见你安装之前已经打开过终端窗口导致 PATH 没有刷新。这时候要么重启终端要么重启电脑。用命令行验证是否成功可以在 CMD 或 PowerShell 里敲latex --version xelatex --version tlmgr --version如果提示“不是内部或外部命令”说明 PATH 有问题。你可以去“系统属性 → 环境变量”里检查一下应该能看到类似 C:\texlive\2026\bin\windows 这个路径。没有的话手动加进去然后再开新终端验证。2.4 macOS 平台安装过程详解macOS 用户最简单的方式是下载 MacTeX。MacTeX 是 TeX Live 的 macOS 发行版安装包是个 .pkg 文件双击一路下一步。装完以后/Library/TeX/texbin 目录会被自动链接到 /usr/local/texlive/2026/bin/universal-darwin终端里直接用 xelatex 就有效。MacTeX 的安装包体积很大同样建议走镜像站。装完以后有一点需要注意如果你在用苹果芯片的 Mac某些老宏包和字体工具可能还是用 x86 版本转译运行的首次使用某个命令的时候系统会弹窗询问是否允许访问网络这个不是病毒点允许就行。另外新系统对安装来源有严格控制如果提示“已损坏无法打开”多数情况是因为安装包的 Gatekeeper 属性没处理好可以右键点安装包选择“打开”再在弹窗里确认一次多数能解决。2.5 Linux 平台安装过程Linux 用户的做法一般是通过发行版自带的包管理器安装。Ubuntu/Debian 系是sudo apt update sudo apt install texlive-fullCentOS/RHEL/Fedora 系是sudo dnf install texlive-scheme-full这种装法省心版本可能比官方仓库略旧一点但对绝大多数用户来说没影响。如果你需要最新版可以下载 install-tl-unx.tar.gz 手动安装命令是tar -xzf install-tl-unx.tar.gz cd install-tl-2026 sudo perl install-tl手动安装会进入交互式界面几个选项里最核心的是 scheme 和安装目录。你可以在命令行前直接指定参数跳过交互sudo perl install-tl --schemefull --no-interaction装完之后要注意Linux 下 TeX Live 的可执行文件默认放在 /usr/local/texlive/2026/bin/x86_64-linux需要把它加到 PATH。Ubuntu 用户可以直接改 ~/.bashrc加一行 export PATH/usr/local/texlive/2026/bin/x86_64-linux:$PATH然后 source ~/.bashrc 生效。提示Linux 手动安装后如果和发行版自带的 texlive 冲突优先卸载系统自带版本否则容易出现“用 apt 装的 latexmk 调用的是系统老版本而你手动装的宏包却更新到了 /usr/local/texlive”这种两套环境打架的情况。3. 编辑器配置让源码编译和预览形成完整闭环3.1 为什么我推荐 VS Code LaTeX Workshop发行版装好了你还需要一个编辑器来写 .tex 文件。记事本也能写但不现实。我推荐 VS Code原因很直接免费、跨平台、插件生态好最核心的是 LaTeX Workshop 这个扩展把编译、查看 PDF、正反向定位全部串起来了配置一次之后就非常顺手。TeXstudio 也很好用自带界面和按钮适合不喜欢折腾的人。但 TeXstudio 的处理某些模板的时候对中文路径的支持不如 VS Code 稳而且竖向分屏预览、代码补全、折叠这些体验VS Code 整体更现代。装 VS Code 本身很简单官网下载对应系统安装包双击下一步即可。这里提醒一句VS Code 安装的时候会问你“添加到 PATH”建议勾选后面某些工具链调用 vscode 命令时会方便很多。3.2 LaTeX Workshop 扩展安装与核心配置项在 VS Code 扩展面板搜索 LaTeX Workshop点安装。装完之后你需要手动改一下配置文件。按下 CtrlShiftPmacOS 是 CmdShiftP输入“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, latex-workshop.latex.autoBuild.run: onSave }这里的核心是把默认编译器设置为 XeLaTeX。为什么要这么设因为 2026 年写中文文档基本都靠 XeLaTeX 配合 ctex 宏包如果用默认的 pdfLaTeX中文环境大概率编译不过去。latex-workshop.latex.recipes 定义了这个项目的编译方案tools 则定义了可用的工具链。view.pdf.viewer 设为 tab意味着 PDF 会在 VS Code 内部标签页打开不用来回切窗口。autoBuild.run 设为 onSave保存文件时自动编译省掉手动点编译按钮的步骤。3.3 正反向搜索从源码跳到 PDF 指定位置LaTeX 写作的高频需求之一是正反向搜索你在源码里看到某一段想快速知道它在 PDF 的第几页或者反过来在 PDF 里看到一个公式想回到源码里改。这需要 SyncTeX 支持而我们在 xelatex 的编译参数里已经加了 -synctex1所以 LaTeX Workshop 天然支持这个功能。在 VS Code 的 LaTeX Workshop 面板里选中你的 .tex 文件然后点左侧的“View LaTeX PDF”按钮PDF 会在新标签页打开。这时候按住 Ctrl 点击 PDF 里的内容会自动跳到源码对应行反过来在源码里按 CtrlAltJ可以定位到 PDF 中对应位置。用熟练之后会觉得这个功能特别值尤其是长论文里来回校对的时候不用一页页翻 PDF 了。TeXstudio 也有类似功能快捷键是 F7 聚焦 PDFCtrl点击定位源码。如果你已经在用 TeXstudio没必要强迁到 VS Code。3.4 TeXstudio 和在线备选方案如果你实在不想折腾 JSON 配置TeXstudio 是一个开箱即用度很高的编辑器。安装之后第一件事同样是把默认编译器改成 XeLaTeX菜单 → 选项 → 设置 TeXstudio → 构建 → 默认编译器选择 XeLaTeX。同时把“PDF 查看器”设为“内置查看器”这样可以边写边看。除了本地方案在线方案 Overleaf 依然值得有备用位置。它的好处是不用装环境、天然统一协同版本、自带数百个模板。坏处是网络不稳定时编译提交很痛苦而且你对本地工具链的控制力会削弱。个人经验是正式论文用本地 VS Code快速草稿和对外协作用 Overleaf两套配合效率最高。4. 从第一个文档到完整编译链路4.1 写一个最小可编译的 LaTeX 文档环境配好了先别急着写论文我们从一个最小文档开始验证整条链路。新建一个文件夹比如 D:\latex-demo在 VS Code 里打开这个文件夹新建文件 test.tex输入以下内容\documentclass[UTF8]{ctexart} \begin{document} 你好LaTeX \begin{equation} E mc^2 \end{equation} \end{document}保存之后LaTeX Workshop 会自动调用 xelatex 编译。第一次编译可能要十几秒因为要生成辅助文件和缓存。等右下角提示编译完成按 CtrlAltV默认是预览 PDF就能看到效果了。如果看到“你好LaTeX”和居中的公式说明环境已经跑通。这个最小文档的意义在于验证三件事ctex 宏包是否能正常加载、中文是否正常显示、公式编译是否正常。如果这里成功后面写长文档基本不会有大问题。4.2 选择正确的编译引擎XeLaTeX 还是 pdfLaTeX很多模板在开头写的是 \documentclass{article}并没有指定编译器。如果你直接拿 xelatex 去编译大概率也能过但格式上可能和模板设计意图有细微出入。有的老模板是专为 pdfLaTeX 准备的里面用了一些不支持 XeLaTeX 的宏包这时候你再怎么编译都会报错。怎么判断呢看文档类代码里有没有用到 fontspec 或 ctex。如果有优先用 XeLaTeX 或 LuaLaTeX如果没有可以先用 pdflatex 试试兼容性会更好。LaTeX Workshop 里可以配置多个 recipes我建议把默认方案配成“XeLaTeX”遇到老模板再临时切换成“pdfLaTeX”。具体做法是在 LaTeX Workshop 面板或者右下角状态栏点击构建按钮旁边的下拉箭头选择其他 recipe 即可。4.3 参考文献编译流程为什么总是显示问号新人最容易懵的一件事参考文献在哪都不对。原因是你只用了一遍编译器但 BibTeX/Biber 的工作流需要多遍。经典流程是xelatex 编译第一遍生成 .aux 文件里面记录了引用标记bibtex 或 biber 编译根据 .aux 里的引用信息从 .bib 文件里拉取参考文献条目生成 .bblxelatex 再编译两遍让交叉引用稳定下来。LaTeX Workshop 其实帮你把事情串起来了前提是你得配置好 recipe。比如使用 biblatex biber 的方案可以这样配{ name: XeLaTeX - Biber - XeLaTeX*2, tools: [ xelatex, biber, xelatex, xelatex ] }如果你用老式 BibTeX 方案把 biber 换成 bibtex 就可以。写完正文后在文档末尾加 \printbibliography如果是 biblatex或者 \bibliography{refs}如果是 BibTeX然后在 .bib 文件里维护条目即可。我强烈建议从最开始就养成分章节维护 .bib 条目的习惯别把参考文献堆在正文里否则后期改格式会非常痛苦。4.4 中文支持与字体配置的实战要点2026 年的 LaTeX 中文支持已经非常成熟了。你只需要注意版本和引擎两个点使用 ctex 宏包或 ctexart 文档类使用 XeLaTeX 或 LuaLaTeX 引擎。如果你在 Windows 上ctex 默认会用系统中文字体宋体、黑体、楷体等在 macOS 上默认使用“宋体-简”等系统字体Linux 上如果没有中文字体需要先安装比如sudo apt install fonts-noto-cjk如果默认字体看着不顺眼可以手动指定最常见的是 Windows 下的“中易宋体”和 macOS 下的“华文宋体”。在导言区写\setCJKmainfont{SimSun}或者你更偏好黑体做正文可以改成\setCJKmainfont{SimHei}注意的是setCJKmainfont 这类命令需要 xecjk 宏包支持而 ctex 宏包已经自动加载了 xecjk 相关功能所以直接用就行。如果你编译报“fontspec 找不到字体”排查思路是先确认系统里确实装了对应字体然后检查字体名称。macOS 下中文字体名称可能是“Songti SC”Windows 下是“SimSun”别写错。5. 常见问题排查与避坑经验实录5.1 命令找不到PATH 配置遇到问题“xelatex 不是内部或外部命令”是出现频率最高的问题。绝大部分原因就是安装完成后 PATH 没刷新或者是安装时把 bin 目录弄丢了。你在 CMD 里敲 echo %PATH%看看有没有类似 C:\texlive\2026\bin\windows。没有就手动加。macOS 上如果执行 xelatex 提示 command not found检查是否有 /Library/TeX/texbin 链接或者直接执行export PATH/usr/local/texlive/2026/bin/universal-darwin:$PATHLinux 同理。测试命令的时候注意每改一次 PATH都要新开一个终端再测因为旧终端的 PATH 不会自动更新。5.2 宏包缺失tlmgr 安装宏包的正确姿势如果你装的是 basic scheme编译时很可能遇到“File xxx.sty not found”。解决办法是用 tlmgr 安装对应宏包。推荐在命令行执行tlmgr install 宏包名但有个坑tlmgr 默认从官方源下载巨慢。需要先换源。配置方式是把源地址改成镜像站的 tltexlive 仓库。以清华源为例tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet tlmgr update --self tlmgr install ctexWindows 用户如果用的是图形界面安装的 TeX Livetlmgr 通常在 PATH 里。Linux 用户如果遇到权限问题加 sudo 执行也可以。这里建议如果你打算用中文并且写论文干脆一开始就装 full scheme省去不断补包的过程。5.3 编译乱码源码编码和编辑器编码不一致中文乱码在 2026 年还是偶尔出现但原因基本已经集中在编码格式上。LaTeX 源码默认推荐使用 UTF-8 编码。VS Code 右下角会显示当前文件编码默认应该是 UTF-8。如果你从旧模板里复制的文件是 GBK 编码在 VS Code 里打开时会乱码可以先点击右下角编码按钮选择“Reopen with Encoding”改用 GBK 打开再全选复制到一个新 UTF-8 文件里。编译乱码还有一种情况是字体没找到导致缺失字形显示成方块。这时候不一定是编码问题先看编译日志里有没有字体警告。用系统字体管理工具查一下有没有对应字体或者像前面说的那样安装 fonts-noto-cjk 等中文字体包。5.4 图片插入失败路径、格式和编译选项图片插不进文档是最常见的实操问题。LaTeX 里插入图片代码长这样\usepackage{graphicx} \begin{figure} \centering \includegraphics[width0.8\textwidth]{figures/result.png} \caption{实验结果} \label{fig:result} \end{figure}容易踩的坑有三个第一是路径不对特别是有空格或中文路径时建议文件名用英文路径别带空格第二是格式不对老版本编译引擎不支持 png/jpg 以外的格式png 和 pdf 最稳第三是忘了写 \centering图片会默认靠左对齐看起来特别不专业。如果你用 Overleaf上传图片时文件名也不要带中文和空格否则可能加载不出来。5.5 常见问题速查表症状可能原因解决方法xelatex 不是内部/外部命令PATH 未配置或未刷新检查环境变量新开终端测试File ctex.sty not found缺少 ctex 宏包tlmgr install ctex或安装 full scheme编译出乱码编码不是 UTF-8用 VS Code 重新打开并按 UTF-8 保存参考文献全问号只编译了一遍使用 xelatex → bibtex/biber → xelatex → xelatex 流程图片不显示路径、格式、缺少 graphicx检查路径、换成 pdf/png、在导言区加 usepackage中文显示空白方块字体缺失安装中文字体检查 fontspec 配置编译时卡住不动宏包临时下载或网络问题查看日志切换镜像源关闭杀毒实时监控安装到一半失败杀毒软件干扰暂时关闭实时监控再装5.6 几条高价值的避坑技巧这些经验来自我这些年自己折腾和帮别人排查的总结不一定写在任何教程里但很管用。第一不要轻易用“完整版安装包 全部默认”之外的方式去装。很多问题都是选了多余选项造成的。第二编译日志永远是第一排查依据。VS Code 的输出面板里能看到完整日志别只看红色报错行往上翻十行真正的报错信息往往藏在中间。第三每次修改完系统环境变量后所有已经打开的程序都建议全部关闭再重开尤其是 VS Code。第四写长文档时建议把 .aux、.bbl、.log 这些中间文件放到单独的临时目录用 latexmk 管理自动清理避免目录混乱。6. 最后再分享一点个人经验装 LaTeX 这件事最怕的就是“总觉得还差一步”。很多朋友卡了很久之后找我帮忙最后发现就是 PATH 没刷新、编码不对、或者编译器选错这类小问题。与其到处问人不如把编译日志当成朋友多读几遍很多答案都在里面。我个人的习惯是装好环境之后先拿一个小文档完整走一遍“写 → 编译 → 看 PDF → 改 → 再编译”的循环确认正反向搜索都好用再开始正式内容。后面写论文的时候你会发现前期这点准备工作非常值。