1. 为什么很多人第一次打开LaTeX就卡在了安装这一步如果你正在读研、写论文、做技术报告或者单纯想把手里的Word文档排版得专业一点那你大概率听过LaTeX这个名字。它不是什么新出的软件而是一套存在了几十年的排版系统核心思路和Word完全不同——你写的是内容加标记它负责把版面算得漂漂亮亮。很多人第一次接触LaTeX是被学长学姐或者导师一句用LaTeX排版吧公式和参考文献省心给带进来的结果打开官网一看下载页面一堆发行版名字装完发现编辑器不会配编译报错看不懂折腾一晚上连个Hello World都没跑出来。这篇内容就是写给这批人的。我不打算一上来就甩一堆命令让你背而是按照一个真实新手从零到跑通第一篇文档的路径来拆先搞清楚LaTeX到底解决什么问题再选一套适合自己的发行版和编辑器组合然后手把手跑通第一个文档最后把新手最容易踩的坑一次性讲透。整篇内容基于我这些年带新人、自己写论文和报告的实际经验凡是涉及工具选型和参数配置的地方我都会说清楚为什么这么选而不是只给一个结论让你照抄。需要提前说明的是LaTeX的生态里工具非常多发行版有TeX Live、MiKTeX、MacTeX编辑器有TeXstudio、VS Code、Overleaf在线版等等。我不会强行推荐某一个最好的因为不同操作系统、不同使用场景下最优解确实不一样。我会把每种组合的适用人群讲清楚你根据自己的情况对号入座就行。另外本文涉及的所有操作步骤都是基于常见实践整理的具体版本号可能随时间变化但核心逻辑是稳定的。2. LaTeX到底在解决什么问题和Word的本质区别2.1 从所见即所得到所想即所得的思维转变用Word的时候你的操作逻辑是所见即所得选中一段文字点加粗它就变粗了拖动标尺段落就缩进了。这种模式直观但有个致命问题——当你文档里有几十个公式、上百条参考文献、几百个交叉引用的时候任何一次格式调整都可能引发连锁反应编号乱了、引用错位了、图片跑位了改起来让人崩溃。LaTeX走的是另一条路叫所想即所得或者更准确地说内容与格式分离。你写的东西长这样\section{引言}意思是这里是一个一级标题内容叫引言。至于这个标题用什么字体、多大字号、前后留多少间距全部由文档类document class和宏包package决定。你不需要关心排版细节只需要关心内容结构。等编译的时候LaTeX引擎会像排字工人一样根据你给的规则把整篇文档的版面算出来。这个转变对新手来说是最难适应的因为你会觉得我连字都看不见怎么知道排出来啥样。但一旦跨过这个坎你会发现它的好处是碾压性的改格式只需要改一行全局设置所有同类元素自动统一公式、图表、参考文献的编号全自动维护插入删除都不会乱文档结构清晰几百页的论文也能轻松管理。2.2 哪些场景下LaTeX的优势是压倒性的不是所有文档都值得用LaTeX。写个请假条、做个简单表格Word或者在线文档明显更快。但以下几类场景LaTeX的优势几乎是压倒性的学术论文和学位论文大量数学公式、定理环境、交叉引用、参考文献管理这些正是LaTeX的强项。尤其是数学公式LaTeX的排版质量至今没有对手。技术书籍和长篇报告章节多、图表多、需要自动生成目录和索引LaTeX的自动化能力能省下大量手工维护的时间。需要严格格式统一的文档比如期刊投稿、会议论文模板一旦确定所有作者产出的格式完全一致不会出现每个人排版风格不一样的问题。含大量数学内容的讲义和试卷公式编号、对齐、多行推导用LaTeX写起来比Word顺手太多。反过来如果你的文档以图文混排为主、需要频繁拖拽调整位置、或者需要多人实时协作编辑那Word或者在线文档可能更合适。工具没有绝对好坏关键看场景匹配。2.3 一个生活化类比LaTeX像点外卖Word像自己下厨我经常用这个类比给新人解释用Word排版就像自己下厨每一步都要亲手操作火候、调料、摆盘全凭手感做一道菜很自由但做一桌宴席就手忙脚乱。用LaTeX更像点外卖——你把需求内容结构写清楚交给平台LaTeX引擎它按标准流程把菜做好送到你面前。你不需要会炒菜但你需要学会怎么把需求描述清楚也就是学会LaTeX的标记语法。这个类比还能解释另一个现象为什么LaTeX新手期特别痛苦。因为点外卖需要你先学会一套点单语言前期学习成本比自己下厨高。但一旦学会点一桌宴席和点一道菜的工作量差不多这就是LaTeX在长篇文档上的规模优势。3. 发行版与编辑器的选型别在第一步就选错工具3.1 发行版是什么为什么不能只装一个编辑器很多新手会问我下载一个LaTeX编辑器不就行了吗这是个典型误解。LaTeX本身是一套排版引擎和宏包集合它需要一个发行版来提供这些底层组件。编辑器只是你写代码的界面真正干活的是发行版里的引擎比如pdfTeX、XeTeX、LuaTeX。打个比方发行版是厨房里的灶台、锅具和食材编辑器是你手里的菜谱本。你光有菜谱本没有灶台是做不出菜的。所以正确的安装顺序是先装发行版再装编辑器最后在编辑器里配置好调用哪个引擎。目前主流的发行版有三个发行版适用系统特点适合人群TeX LiveWindows/Linux/macOS跨平台宏包最全一次装好基本不用再管追求稳定、不想折腾的人MiKTeXWindows为主按需下载宏包安装体积小但首次编译可能频繁联网硬盘空间紧张、网络稳定的人MacTeXmacOS基于TeX Live的Mac定制版开箱即用Mac用户我的建议很直接如果你硬盘空间够完整版大概几个GB直接上TeX Live或者MacTeX选完整安装。虽然下载慢一点但后续不会因为缺宏包而反复报错。MiKTeX的按需下载机制听起来很美好但实际用起来尤其是断网或者宏包源不稳定的时候会让人抓狂。3.2 编辑器怎么选本地还是在线编辑器这块新手最容易纠结。我把它分成两大类本地编辑器TeXstudio、VS Code LaTeX Workshop插件、WinEdt、TeXmaker等。本地编辑器的好处是响应快、不依赖网络、可以离线工作适合长期写长篇文档的人。TeXstudio是专门为LaTeX设计的开箱即用功能齐全对新手最友好。VS Code则需要装插件、配配置灵活但门槛稍高。在线编辑器Overleaf这类平台。好处是零安装、跨设备、方便协作和分享特别适合临时写个作业或者多人合作。缺点是依赖网络免费版有编译时长限制敏感内容不适合放上去。我的实际经验是新手先用TeXstudio或者Overleaf跑通第一个文档建立信心等确定要长期用了再考虑迁移到VS Code这种可定制性更强的环境。不要一上来就折腾VS Code配置那会让你在还没体会到LaTeX好处之前就被配置劝退。3.3 中文用户必须注意的引擎选择这是中文用户特有的坑。LaTeX默认的pdfTeX引擎对中文支持不好直接编译中文会报错或者输出乱码。解决办法是换引擎XeLaTeX目前中文排版最推荐的引擎配合ctex宏包或ctexart文档类能直接调用系统字体中文支持非常好。LuaLaTeX功能更强支持Unicode和OpenType字体但编译速度稍慢配置略复杂。pdfLaTeX不推荐中文用户使用除非你愿意折腾各种中文宏包。所以在编辑器里配置编译链的时候中文文档一定要选XeLaTeX。TeXstudio里可以在选项-构建里把默认编译器改成XeLaTeXVS Code的LaTeX Workshop则需要在配置文件里指定latexmk使用-xelatex参数。这个设置不做好后面所有中文内容都会出问题。4. 从零跑通第一个文档完整操作链路4.1 安装发行版的实际步骤与注意事项以TeX Live为例说下安装流程。官网下载安装包后Windows用户运行install-tl-windows.batmacOS和Linux用户运行install-tl脚本。安装界面里有个关键选项叫Scheme建议选scheme-full完整安装。虽然体积大但省去了后续缺宏包的麻烦。安装过程可能持续半小时到一小时取决于网速。这里有个实操心得安装路径不要带中文和空格比如D:\texlive\2024这种就很好D:\我的软件\LaTeX 安装这种路径在某些情况下会引发奇怪的编译错误。这个坑我见过太多次了很多人报错报了半天最后发现是路径里有中文。安装完成后打开命令行输入tex --version如果能输出版本信息说明安装成功。再输入xelatex --version确认XeLaTeX引擎可用。这两步验证很重要能提前发现环境变量没配好的问题。4.2 编辑器配置让编译一键完成以TeXstudio为例安装后打开先做三件事设置默认编译器选项 - 构建 - 默认编译器选XeLaTeX。设置编码选项 - 编辑器 - 默认字体编码选UTF-8。这样中文不会乱码。配置命令确认XeLaTeX的调用路径指向你安装的发行版。通常TeXstudio会自动检测如果没检测到手动指定到安装目录/bin/windows/xelatex.exe。配置好后按F5或者点那个绿色箭头就能编译。TeXstudio默认会先编译再预览如果报错会在下方显示日志。新手看日志容易懵我的建议是先看日志最上面第一个!开头的错误行那通常是根源后面的错误往往是连锁反应。4.3 第一个文档逐行拆解一个最小可运行示例下面这个例子是我给新人用的标准模板你直接复制到编辑器里保存为test.tex用XeLaTeX编译\documentclass[UTF8]{ctexart} \title{我的第一个LaTeX文档} \author{某开发者} \date{\today} \begin{document} \maketitle \section{引言} 这是一个中文测试文档。LaTeX的中文排版需要配合ctex宏包或文档类。 \section{数学公式示例} 行内公式$E mc^2$。 行间公式 \begin{equation} \int_{0}^{1} x^2 \, dx \frac{1}{3} \end{equation} \section{列表示例} \begin{itemize} \item 第一项 \item 第二项 \end{itemize} \end{document}逐行解释一下关键部分\documentclass[UTF8]{ctexart}声明文档类。ctexart是专门为中文文章设计的文档类自带中文支持。[UTF8]指定编码。\title、\author、\date定义标题、作者、日期这些不会直接显示需要\maketitle来生成。\begin{document}和\end{document}文档正文的边界所有内容写在这中间。\section{}一级标题LaTeX会自动编号。$...$行内公式\begin{equation}...\end{equation}是带编号的行间公式。\begin{itemize}...\end{itemize}无序列表。编译成功后你会得到一个PDF里面有标题、两个章节、一个公式和一个列表。这就是LaTeX的基本工作流写标记 - 编译 - 看PDF。4.4 编译报错时新手应该按什么顺序排查第一次编译大概率不会一帆风顺。我总结了一个排查顺序按这个来能解决八成问题看第一个错误行日志里第一个以!开头的行是根源后面的错误可能是它引发的。检查引擎中文报错先确认是不是用了XeLaTeX。用pdfLaTeX编译中文文档必错。检查宏包提示File xxx.sty not found说明缺宏包。TeX Live完整版一般不会缺MiKTeX会自动下载。检查括号和反斜杠\begin{}和\end{}必须成对命令的反斜杠不能少。这类语法错误最常见。检查路径文档路径有中文或空格可能导致编译失败换个纯英文路径试试。清理辅助文件有时候.aux、.log等辅助文件损坏会导致诡异错误删掉重新编译。提示TeXstudio里有个清理辅助文件的功能遇到莫名其妙的错误可以先清理再编译能省不少时间。5. 新手最容易踩的五个坑及规避方法5.1 中文乱码与字体缺失根源在引擎和宏包中文乱码是新手遇到的第一大坑。表现是PDF里中文变成空白、方框或者乱码。根源通常有两个一是用了pdfLaTeX引擎二是没有正确加载中文宏包。正确的做法是用XeLaTeX引擎文档类用ctexart、ctexrep、ctexbook或者在\documentclass{article}之后加载\usepackage{ctex}。ctex宏包会自动处理中文字体、标点和行距是中文排版的标准方案。如果编译时报字体找不到说明系统里缺对应字体。Windows一般有宋体、黑体macOS有华文宋体等。ctex默认会调用系统字体如果缺字体可以在导言区用\setCJKmainfont{字体名}手动指定。这个细节新手容易忽略但一旦遇到就很卡人。5.2 宏包冲突为什么加了新宏包反而编译不过LaTeX的宏包生态很庞大但宏包之间偶尔会冲突。典型表现是单独用A宏包没问题单独用B宏包也没问题两个一起用就报错。常见冲突包括选项冲突两个宏包都要求某个选项的不同值和命令重定义两个宏包定义了同名命令。规避方法有几个一是尽量用较新的宏包版本很多冲突在新版里已经修复二是注意宏包的加载顺序有些宏包必须在其他宏包之前或之后加载三是遇到冲突时查宏包文档看有没有兼容性说明。我的经验是不要盲目堆砌宏包能用文档类自带功能解决的就不要额外加载宏包。5.3 编译速度慢哪些操作在拖后腿LaTeX编译慢是正常现象尤其是长篇文档。但有些操作会显著拖慢速度频繁使用\usepackage加载大量宏包每个宏包都要解析加载越多越慢。大量TikZ绘图TikZ功能强大但编译开销大复杂图形会明显拖慢编译。反复编译交叉引用和参考文献需要多次编译才能稳定但没必要每次都全量编译。提速的方法用latexmk工具自动管理编译次数只编译必要的遍数把不常改动的章节拆分成单独文件用\include引入编译时只编译当前章节复杂图形可以先导出为PDF再插入而不是每次都用TikZ重绘。5.4 参考文献和交叉引用为什么编号总是对不上参考文献和交叉引用是LaTeX的强项但新手经常遇到编号对不上引用显示问号的问题。根源通常是编译次数不够。LaTeX的交叉引用机制需要至少编译两遍第一遍收集标签信息写入.aux文件第二遍才能正确显示编号。如果用了BibTeX或BibLaTeX处理参考文献还需要额外的编译步骤。正确的编译顺序是XeLaTeX - BibTeX/Biber - XeLaTeX - XeLaTeX。TeXstudio和VS Code都可以配置自动执行这个流程。如果引用显示??先别慌多编译几遍通常就好了。如果还是不行检查.aux文件是否生成、标签名是否拼写一致。5.5 版本管理与协作.tex文件该怎么管LaTeX项目会产生一堆辅助文件.aux、.log、.out、.toc等这些文件是编译过程中生成的不需要手动管理也不应该提交到版本控制系统。用Git管理LaTeX项目时建议加一个.gitignore文件把辅助文件排除掉只保留.tex、.bib、图片等源文件。多人协作时最大的坑是每个人编译环境不一样导致格式不一致。解决办法是统一发行版版本、统一编译引擎、统一宏包版本。如果条件允许用Overleaf这类在线平台协作能避免大部分环境差异问题。但要注意涉及敏感内容的文档不要放到在线平台。6. 从入门到能用的下一步学习路径与资源取舍6.1 不要系统学完再动手边写边查才是正路LaTeX的命令和宏包成千上万想系统学完再动手是不现实的也是效率最低的。正确的路径是掌握最小必要知识文档结构、章节、公式、图表、引用然后直接开始写你真正要写的文档遇到不会的再查。我见过太多人买了一本厚厚的LaTeX书从第一页开始啃啃到第三章就放弃了。LaTeX是工具工具要在使用中学习。你写第一篇文档时可能只会用\section和$...$写第二篇时学会了插入图片写第三篇时学会了表格这样积累下来几篇文档之后你就基本能应付大部分场景了。6.2 常用宏包清单先掌握这几个就够用了新手不需要记一堆宏包先掌握下面这几个能覆盖八成日常需求宏包用途备注ctex中文支持中文文档必备graphicx插入图片\includegraphics命令amsmath数学公式增强多行公式、对齐环境booktabs专业表格线\toprule、\midrule、\bottomrulehyperref超链接和PDF书签通常最后加载geometry页面边距设置一行命令调整页边距biblatex参考文献管理配合Biber使用这几个宏包学透日常写论文、报告基本够用。其他宏包用到再查不用提前囤。6.3 遇到问题时的求助姿势怎么问才能快速得到答案LaTeX社区很活跃但提问方式决定了你能不能快速得到帮助。一个高质量的提问应该包含最小可复现示例把出问题的代码精简到最少能独立编译并复现错误。完整错误信息把日志里第一个错误行贴出来不要只说报错了。环境信息操作系统、发行版版本、编译引擎、相关宏包版本。你已经尝试过什么说明你排查过哪些方向避免别人重复建议。我见过很多提问只写一句LaTeX编译报错怎么办这种问题没人能回答因为信息量为零。把最小示例和错误日志准备好问题往往自己就解决了一半——因为整理示例的过程就是排查的过程。6.4 一个实际体会LaTeX的学习曲线是先陡后平最后分享一个我自己的体会。LaTeX的学习曲线和很多工具不一样它是先陡后平入门阶段特别痛苦装环境、配编辑器、记命令、调错误每一步都在劝退但一旦跨过某个临界点你会发现后面越来越顺写长篇文档的效率反而比Word高得多。这个临界点大概在哪里我的观察是当你独立写完一篇包含公式、图表、参考文献的完整文档并且成功编译出符合要求的PDF时你就跨过去了。之后遇到的新问题大多是某个宏包怎么用这种查文档就能解决的问题而不是整个流程跑不通的阻塞性问题。所以如果你现在正卡在安装或者第一个文档编译不过别灰心这是每个人都会经历的阶段。把本文的步骤走一遍遇到报错按第4.4节的顺序排查大概率能跑通。跑通第一个文档之后后面的路就好走多了。