第一次装 LaTeX 的人十个里有八个会卡在同一个地方安装包装完了编辑器也打开了点了编译屏幕上刷出一屏红字。更难受的是这屏红字里没有一个汉字你不知道该从哪一行看起。我见过太多人在这时候放弃转头回去继续用 Word 手敲公式然后在某个深夜因为公式编号对不齐而崩溃。这篇 LaTeX 安装教程要解决的问题就一个让你从零开始把 LaTeX 环境搭起来并且第一次编译就能出中文。不管你是 Windows、macOS 还是 Linux不管你是要写毕业论文、投期刊还是单纯想让数学公式好看一点下面的流程都能直接照着做。我会把每个步骤背后为什么要这么选讲清楚因为 LaTeX 安装这件事坑基本都不在操作本身而在于你选错了发行版或者选错了编译器引擎后面怎么调都是白费劲。先说一个反常识的结论LaTeX 不是一个软件它是三样东西拼起来的。你下载的那个几个 G 的安装包只是其中一部分。1. 装之前先搞明白LaTeX 到底是个什么组合体很多人对 LaTeX 的第一印象是一个排版软件跟 Word 是同一类东西。这个认知偏差是后面所有困惑的源头。LaTeX 实际上的结构比这松散得多它是由发行版、编译引擎、编辑器三个相对独立的层叠起来的每一层都可以单独换。搞不清这层关系你就会在我明明装了 LaTeX 为什么还要装 TeXstudio这类问题上反复打转。1.1 发行版、编译器、编辑器三者的职责边界发行版distribution是最大的那一坨里面装着 TeX 引擎、几千个宏包、字体文件、文档。TeX Live、MiKTeX、MacTeX 都属于这一类。你可以把它理解成一个全家桶它决定了你手上到底有哪些零件可用。编译引擎是真正干活的那个程序负责把你的.tex源码翻译成 PDF。常见的几个pdflatex、xelatex、lualatex。它们不是同一个程序的不同版本而是处理字符的方式不一样。这个区别后面会专门讲因为它直接决定你的中文能不能编译出来。编辑器是你写代码的地方它跟 LaTeX 本身没关系。TeXstudio、VS Code、Overleaf 都是编辑器甚至你用记事本写.tex文件也不是不行只是没有语法高亮和自动补全而已。三层分清楚之后很多问题就好理解了。比如我装了 VS Code 为什么还是编译不了答案是 VS Code 只是编辑器它需要调用底层的引擎而引擎来自发行版。再比如为什么别人的文档我编译不过多半是他的文档用到了你发行版里没装的宏包。1.2 为什么不推荐新手直接上 CTeX 套装早些年中文用户圈子里流传最广的是 CTeX 套装一键安装装完就能写中文。听起来很省事但我现在基本不推荐给任何人尤其是准备写毕业论文的人。原因有三个。第一CTeX 套装最后一次更新停在很多年前它打包的 TeX Live 版本已经非常老现在很多期刊模板和宏包要求较新的内核用老版本会遇到各种莫名其妙的不兼容。第二它自带的那套字体和宏包配置是硬编码的你想换字体或者升级宏包会跟它自带的版本打架。第三也是最要命的CTeX 套装会往系统里写不少环境变量和注册表项卸载不干净的话后面你再装 TeX Live 会互相干扰出现明明装了新版却调用到旧版的诡异现象。替代方案很简单装最新的 TeX Live中文用ctex宏包配合xelatex引擎处理。这条路是目前维护最活跃、兼容性最好的也是绝大多数高校模板默认要求的。1.3 三套主流发行版该怎么选发行版适用系统体积特点TeX LiveWindows / Linux / macOS完整安装约 7-8 GB跨平台每年 4 月发新版宏包最全高校模板的事实标准MiKTeX主要 Windows按需下载初始几百 MB缺宏包时自动下载适合磁盘紧张的场景但联网编译有不确定性MacTeXmacOS约 5-6 GB本质是 TeX Live 的 macOS 打包版额外带了一些 Mac 专用工具TinyTeX全平台初始约 100 MB精简版按需装宏包适合有经验的人或 CI 环境我的建议很直接硬盘够就装 TeX Live / MacTeX 完整版。多占几个 G 换来的是以后再也不会因为缺宏包而报错这笔账非常划算。MiKTeX 的自动装包听起来很方便但在断网、代理、宏包源不稳定的时候它会卡在编译中间给你一个莫名其妙的超时错误排查起来反而更费时间。2. Windows 上装 TeX Live从下载到跑通第一个中文文档Windows 是用户最多、也最容易出问题的平台所以这一节讲得最细。整个流程我建议留出至少一个小时其中大部分时间是在等它解压和安装你不需要一直盯着。2.1 安装包从哪拿怎么选下载方式官方下载页在国际网络上速度通常很慢。更实际的做法是用国内高校的开源镜像站这些镜像站同步 CTANTeX 的官方宏包库的内容速度和稳定性都更好。清华、中科大、上海交大等都有 CTAN 镜像直接搜索CTAN 镜像就能找到对应地址。在镜像站的systems/texlive/tlnet/目录下你会看到两种获取方式install-tl-windows.exe一个几十 MB 的在线安装器运行时边下边装总下载量取决于你选了多少组件。texlive.iso一个 5 GB 左右的完整镜像文件下载完挂载或解压后本地安装。两者的最终结果是一样的。区别在于在线安装器中途断网就得重来而 ISO 下载支持断点续传。如果你家网络不太稳定我建议咬牙下 ISO虽然下得久但下完了安装过程不依赖网络心理上踏实很多。提示不要去找所谓的绿色版精简版破解版安装包。TeX Live 本身完全免费开源任何打着这类旗号的包要么是旧版本重新打包要么捆绑了你不想要的东西。直接从官方镜像站下就行。2.2 安装向导里几个容易选错的地方双击安装器之后会进入一个图形界面大部分人一路默认点下去然后在某个选项上栽跟头。下面几处需要留意。安装路径。默认是C:\texlive\20XX其中 XX 是年份。我建议保持默认或者改到 D 盘根目录下的类似路径。路径里千万不要有中文、空格、特殊符号。这不是 LaTeX 独有的要求但 LaTeX 对这类字符的容忍度特别低一旦路径里有中文宏包查找和字体加载都可能出问题而且报错信息不会直接告诉你是路径的锅排查起来极其痛苦。安装方案。向导会问你是完整安装还是自定义。新手直接选完整安装Full占 7-8 GB。如果你确实磁盘紧张可以在自定义里去掉一些你永远不会用的语言包比如日文、韩文相关的 collection但保留collection-langchinese这个后面中文排版要用。是否修改 PATH。这个选项一定要勾上。它会把 TeX Live 的可执行文件目录写进系统环境变量这样你在命令行里敲xelatex才能直接被找到。如果不勾你得自己手动加很多人就是漏了这一步导致装完了但命令行说找不到命令。是否安装 TeXworks。这是 TeX Live 自带的一个极简编辑器功能很基础。装不装都行我一般勾上万一后面的编辑器配置出问题还能用它做个对照测试判断问题到底出在引擎还是编辑器上。2.3 装完之后的两项验证安装流程走完最后会提示 Welcome to TeX Live但这时候别急着庆祝。开一个新的命令行窗口一定要是新开的老窗口读不到刚写入的环境变量依次执行tex --version xelatex --version tlmgr --version三条命令都应该输出版本信息。如果提示不是内部或外部命令说明 PATH 没生效。这时候去系统属性 → 高级 → 环境变量在系统变量的Path里加上 TeX Live 的 bin 目录Windows 上一般是D:\texlive\2024\bin\windows注意年份要跟你实际装的对上。加完之后再开一个新命令行验证。第二项验证是把宏包管理器tlmgr的源换成国内镜像不然以后装宏包会慢到怀疑人生tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet/换完之后可以跑一次tlmgr update --self更新管理器自己再跑tlmgr update --all更新所有宏包。第一次全量更新可能要十几分钟可以放着去干别的。2.4 第一个能编译出中文的文档到这一步环境是通了但能编译和能编译中文是两回事。新建一个文件叫hello.tex内容如下\documentclass[UTF8]{ctexart} \begin{document} 你好世界 这是一个用 \XeLaTeX{} 编译的中文文档。 数学公式测试$E mc^2$ \end{document}然后在文件所在目录打开命令行用xelatex而不是 pdflatex 编译xelatex hello.tex顺利的话同目录下会生成hello.pdf。打开看到你好世界恭喜你环境彻底通了。这里有个新手最容易踩的坑用pdflatex hello.tex编译上面这段代码会报一堆关于字体的错误。原因就在下一节要讲的引擎差异。记住这个结论就行中文文档一律用 xelatex 或 lualatex。3. macOS 与 Linux两条比 Windows 更省心的路径如果你用的是 Mac 或者 Linux安装过程其实比 Windows 简单因为系统的包管理生态更成熟。但简单不代表没有雷macOS 上最大的雷是磁盘空间Linux 上最大的雷是装了但不全。3.1 macOS 上 MacTeX 的体积取舍MacTeX 的安装包是一个.pkg文件下载完双击一路继续就行。它默认装到/usr/local/texlive/2024并且会自动把命令行工具链接到/usr/local/bin所以装完之后不需要手动配 PATH开个终端敲xelatex --version就能验证。问题在于体积。MacTeX 完整版安装后接近 6 GB对 256 GB 硬盘的 MacBook 来说不算小事。如果你实在没空间有两条路BasicTeX只有几百 MB包含最基本的引擎和宏包。缺点是你写一个稍微复杂点的文档就会缺宏包需要用tlmgr install一个个补。TinyTeX谢益辉开发的一个精简发行版专门为按需安装设计。安装脚本是install-unx.sh装完之后缺什么宏包它会提示你用tlmgr install xxx补上即可。我的建议是如果你是长期用 LaTeX 写论文或者做笔记直接上完整版 MacTeX把空间问题交给外置硬盘或者云盘。按需装宏包这件事在你赶 deadline 的时候会变成压垮情绪的最后一根稻草。3.2 Linux 下包管理器和官方安装脚本的取舍Debian / Ubuntu 系可以用 aptsudo apt update sudo apt install texlive-fulltexlive-full的体积在 5 GB 左右装的是发行版维护者打包的版本。优点是跟系统集成好卸载干净。缺点是版本通常比官方 TeX Live 落后一到两年某些新宏包或者新模板可能用不了。如果你需要最新版本用官方安装脚本wget https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet/install-tl-unx.tar.gz tar -xzf install-tl-unx.tar.gz cd install-tl-*/ sudo ./install-tl -repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet/进入交互界面后输入I开始安装。装完之后需要把 bin 目录加进 PATH在~/.bashrc或~/.zshrc里加一行路径里的年份和架构要按实际改export PATH/usr/local/texlive/2024/bin/x86_64-linux:$PATHFedora / RHEL 系对应的是texlive-scheme-fullArch 系是texlive-meta。这些都是各发行版的包名约定不确定的话先apt search texlive之类查一下。注意不要同时用包管理器和官方脚本装两套 TeX Live。两套并存的结果是 PATH 里谁在前谁生效你以为是新版在跑实际调用的是旧版编译报错会非常迷惑。选一条路走到底。3.3 三个平台通用的排错自检不管你用哪个系统装完之后跑这三条命令能快速判断环境是否完整kpsewhich ctexart.cls kpsewhich article.cls tlmgr info ctex第一条查中文文档类是否存在第二条查基础文档类第三条查宏包信息。如果第一条返回空说明中文支持没装全用tlmgr install ctex补上。第 3.2 节提到的 apt 装法有些配置里texlive-lang-chinese是单独的包需要额外装否则ctex会缺失。4. 编辑器怎么配TeXstudio 和 VS Code 两条路线环境通了之后接下来是编辑器。用命令行写.tex当然可以但你不会想这么干的。编辑器的价值在于语法高亮、命令补全、错误定位、一键编译这些能把你的写作效率提高好几倍。4.1 TeXstudio 的三处必改设置TeXstudio 是专门为 LaTeX 设计的编辑器开箱即用程度最高对新手最友好。装完之后默认配置基本能用但有三处我建议改掉。默认编译器改成 XeLaTeX。菜单选项 → 设置 TeXstudio → 构建把默认编译器从pdflatex改成xelatex。这样你按 F5 编译时就不会因为中文字体报错。打开构建时自动保存。默认情况下 TeXstudio 编译的是磁盘上的文件如果你改了代码没保存就编译看到的是旧结果。开启自动保存可以避免这种我明明改了怎么没生效的困惑。设置拼写检查语言和编码。编码统一用 UTF-8这个在新版本里通常是默认的但值得确认一下。如果你从别处复制来的模板是 GBK 编码打开会乱码需要在保存时另存为 UTF-8。TeXstudio 还有一个很实用的功能编译日志和 PDF 的联动。在 PDF 里双击某个位置会自动跳到源码里对应的行反过来在源码里点某行PDF 会高亮对应位置。这个功能在改长文档的时候特别好用前提是编译时开启了-synctex1选项TeXstudio 默认是开的。4.2 VS Code LaTeX Workshop 的配置细节如果你已经在用 VS Code 写别的语言那用 VS Code 写 LaTeX 可以少装一个软件。核心是要装LaTeX Workshop扩展作者是 James Yu然后在settings.json里配置编译工具链。最小可用配置大概是这样{ latex-workshop.latex.tools: [ { name: xelatex, command: xelatex, args: [-synctex1, -interactionnonstopmode, -file-line-error, %DOC%] }, { name: bibtex, command: bibtex, args: [%DOCFILE%] } ], latex-workshop.latex.recipes: [ { name: xelatex - bibtex - xelatex*2, tools: [xelatex, bibtex, xelatex, xelatex] } ] }这段配置里几个参数值得解释一下。-synctex1生成同步信息让 PDF 和源码能互相跳转。-interactionnonstopmode让编译遇到错误时不停下来等你输入否则在编辑器里编译会卡住。-file-line-error让报错格式变成文件:行号:错误方便 VS Code 直接定位到出错的行。那个xelatex 跑一遍bibtex 跑一遍再 xelatex 跑两遍的配方是处理带参考文献文档的标准套路原因在 4.4 节讲。4.3 三种编译引擎到底差在哪这是 LaTeX 安装里最值得花五分钟搞清楚的知识点因为它能帮你省下几个小时的排错时间。引擎中文支持字体处理适用场景pdflatex差需 CJK 宏包配置繁琐传统 TFM 字体纯英文文档、老模板xelatex好原生支持 Unicode系统字体用 fontspec 调用中文文档首选期刊模板常用lualatex好原生支持 Unicode系统字体且支持 Lua 脚本需要编程扩展的场景编译稍慢差异的根源在于字符编码的处理方式。pdflatex诞生于 ASCII 时代它对每个字符用 8 位编码表示中文字符有上万个8 位根本装不下所以必须靠 CJK 宏包把汉字拆成区位码来拼配置极其麻烦。xelatex和lualatex原生按 Unicode 处理文本一个汉字就是一个字符直接调用系统里的中文字体不需要任何额外编码转换。所以中文文档必须用 xelatex 或 lualatex这个结论不是习惯问题是技术上的必然。现在绝大多数中文期刊和高校的模板都会在说明文档里明确写请使用 XeLaTeX 编译。那 xelatex 和 lualatex 怎么选如果你的文档不需要 Lua 脚本、不需要直接调用系统命令用 xelatex 就行它的生态更成熟宏包兼容性更好。lualatex 的优势在于可以用 Lua 写扩展逻辑比如做复杂的图表计算但编译速度会慢一些遇到不兼容宏包的概率也略高。4.4 为什么有的文档要编译四遍新手看到编译四遍会觉得莫名其妙其实原因很朴素LaTeX 是单趟扫描的它自己也不知道某个章节在第几页。第一遍编译时LaTeX 把所有章节标题、图表、公式、参考文献的位置信息记录到辅助文件里.aux、.toc、.lof等这时候正文里的交叉引用还是问号。第二遍编译时它读上一遍生成的辅助文件把引用替换成正确编号但页码可能因为内容变长而错位需要再跑一遍校正。有参考文献的时候中间还得插一次 bibtex 处理.bib文件生成条目列表。latexmk这个工具就是干这事的它会自动分析辅助文件之间的依赖关系判断需要跑几遍直到结果稳定。配置好之后你只需要敲一句latexmk -xelatex -pvc main.tex-pvc是持续监测模式它会盯着你的.tex文件一有改动就自动重新编译配合编辑器的 PDF 预览体验上跟实时预览差不多。写论文的时候开这个模式改完一段切过去就能看到排版效果。如果你用 VS CodeLaTeX Workshop 也内置了类似的自动编译功能在设置里开启latex-workshop.latex.autoBuild.run就行。5. 中文排版这道坎字体、编码与 ctex 宏包英文环境下 LaTeX 装完就能用中文环境下真正的麻烦才开始。这一节讲的都是实操中会直接撞上的问题。5.1 ctex 宏包和 ctexart 文档类的关系ctex是一整套中文排版支持的集合它做了三件核心的事把中文断行规则接进去中文没有空格换行逻辑跟英文完全不同、设置中文字体、调整章节标题和图表题注的中文样式比如图 1而不是Figure 1。用它有两种方式。一种是直接用ctexart、ctexbook、ctexrep这些文档类它们相当于article、book、report加上中文配置\documentclass[UTF8]{ctexart}另一种是保留原来的文档类只加载宏包\documentclass{article} \usepackage[UTF8]{ctex}大部分国内高校的学位论文模板都是第二种方式因为模板本身要基于book或report做大量定制。你自己写文档的话用ctexart更省事。5.2 中文字体在不同系统上的差异这是跨平台作者最容易忽略的问题Windows 上能编译的文档拿到 Mac 或者 Linux 上可能报字体找不到。根本原因是ctex默认使用的中文字体是按操作系统自动挑选的。Windows 上它挑宋体、黑体、楷体、仿宋macOS 上挑华文宋体之类的Linux 上如果没装中文字体就会直接报错。所以如果你的文档要给别人编译或者你在多台机器上工作最好显式指定字体。用fontspec手动指定字体是这样写的\usepackage{fontspec} \setmainfont{Times New Roman} \setCJKmainfont{SimSun} \setCJKsansfont{SimHei} \setCJKmonofont{FangSong}这里有个坑字体名必须跟系统里注册的名称完全一致SimSun可以simsun有时候就不行宋体也可能行也可能不行取决于系统的字体索引。稳妥的做法是用fc-list命令Linux / macOS或者去 Windows 字体目录里核对准确名称。提示如果你的文档只在自己电脑上用不要折腾字体配置让 ctex 自动选就行。跨平台的时候再手动指定而且最好用那些多平台都有的字体比如思源宋体Source Han Serif。5.3 一个能直接用的中文文档骨架把前面这些串起来给你一个我平时开新文档直接复制的骨架\documentclass[UTF8, a4paper, 12pt]{ctexart} \usepackage{geometry} \geometry{left2.5cm, right2.5cm, top2.5cm, bottom2.5cm} \usepackage{graphicx} \usepackage{amsmath, amssymb} \usepackage{tabularx} \usepackage{hyperref} \title{文档标题} \author{你的名字} \date{\today} \begin{document} \maketitle \begin{abstract} 这里是摘要。 \end{abstract} \section{引言} 正文从这里开始。 \section{方法} \subsection{子小节} 内容。 \end{document}geometry负责页边距不设置的话默认边距在国内的排版习惯里显得太窄。amsmath和amssymb是数学公式必备tabularx用来做自动换行的表格hyperref生成 PDF 书签和可点击的目录。这几个宏包几乎每个正经文档都会用到提前加上省得后面一个个补。6. 装完之后一定会撞上的报错从日志定位问题环境搭好只是开始真正耗时间的是处理编译报错。这一节我按最常见到最罕见的顺序排你可以当成速查表用。6.1 宏包缺失和 tlmgr 的正确用法最常见的报错长这样! LaTeX Error: File xxx.sty not found.这是说某个宏包没装。解决方法是装它tlmgr install xxx但有两个前提。第一你用的是完整版 TeX Live 还是按需版完整版通常不会有这个问题出现了说明这个宏包比较新或者不在默认集合里。第二tlmgr的源得是能用的如果是官方的国际源可能会因为网络问题超时换成国内镜像就快很多。装完之后如果还是报同样的错八成是文件名写错了。宏包的.sty文件名和你在\usepackage{}里写的名字经常不一致比如你需要用\usepackage{tikz}但实际的文件可能是tikz.sty依赖的十几个子包。这种情况直接去 CTAN 上搜包名看它的文档说明。还有一个隐蔽的坑宏包冲突。两个宏包都重定义了同一个命令就会报Command \xxx already defined。这种情况通常需要调整加载顺序或者用\usepackage[options]{pkg}里的选项关掉其中一个的行为。这类问题没有通用解法得看具体报错。6.2 文件名、路径和权限的隐形陷阱有一类问题不会给你明确的错误信息只是编译结果不对或者干脆卡住。这类问题十有八九是文件系统层面的。文件名里的空格和中文。我的论文.tex这种文件名在某些工具链里会导致宏包路径解析失败。养成习惯文件名只用英文字母、数字、下划线和连字符比如thesis_main.tex。图片文件名里的特殊字符。同样的道理图片叫图1.png可能在\includegraphics时报错改成fig1.png。另外注意扩展名的大小写Linux 上是区分大小写的Fig.PNG和fig.png是两个不同的文件。文件被占用。在 Windows 上如果你用 PDF 阅读器打开了生成的 PDF再点编译可能会因为文件被锁而写入失败。TeXstudio 有个选项叫编译前关闭 PDF 阅读器或者直接用内置的 PDF 预览窗口能避免这个问题。权限问题。在 Linux 或 macOS 上如果你把项目放在系统目录下比如/usr/local/编译时需要写辅助文件的权限可能会失败。项目文件放在你的用户目录下最稳妥。6.3 怎么读编译日志LaTeX 的日志又长又乱但它其实有规律。报错行以!开头后面跟错误描述。关键是看!后面的第一行以及紧跟着的那一行——那一行告诉你出错时正在处理哪个文件、哪一行代码。如果错误信息里出现l.123这样的标记说明问题在源文件的第 123 行附近。定位到那一行往回看一两行通常能找到原因。最常见的是漏了}、漏了\end{}、或者用了没加载的宏包里的命令。-file-line-error这个编译选项强烈建议打开它会把错误格式化成文件名:行号: 错误描述比默认格式好读很多编辑器也能直接解析并跳转。如果日志里全是Overfull \hbox之类的警告先别管。这些是排版警告意思是某一行排得太宽或者太窄LaTeX 已经自动处理了通常是让字距稍微紧一点不影响 PDF 生成。真正要处理的是以!开头的错误以及Warning: Citation xxx undefined这类引用警告通常多编译一遍就好。7. 从能编译到能交付图片、表格、公式与模板环境搭好、报错会看了接下来就是真正用它干活。这一节挑几个最高频的痛点讲都是我自己踩过坑之后总结出来的写法。7.1 插入图片和浮动体的位置控制基本写法\usepackage{graphicx} \begin{figure}[htbp] \centering \includegraphics[width0.8\textwidth]{fig1.png} \caption{示例图片} \label{fig:demo} \end{figure}[htbp]这四个字母是位置偏好here当前位置、top页顶、bottom页底、page单独一页。LaTeX 会按这个优先级找位置但它不是命令只是建议。如果图片太大放不下LaTeX 会把它挪到后面甚至挪到下一节之后。想让图片老老实实待在你写的位置可以用float宏包提供的[H]选项\usepackage{float} \begin{figure}[H]但这会带来一个新问题图片太大会把页面撑破出现一片空白。所以更推荐的做法是只在真正需要的时候用H其他情况接受 LaTeX 的自动排布那其实是它比较专业的间距计算。用\label和\ref引用图片时要注意\label必须写在\caption之后否则引用到的编号是上一节的。引用时写图~\ref{fig:demo}那个~是不换行空格防止图和数字被分到两行。7.2 表格自动换行怎么处理LaTeX 默认的tabular环境里单元格内容不会自动换行文字会一直往右顶超出页面宽度。想要自动换行有几种方案。最简单的是用tabularx把要换行的列类型写成X\usepackage{tabularx} \begin{table}[htbp] \centering \caption{对比表} \begin{tabularx}{\textwidth}{|l|X|X|} \hline 项目 说明 备注 \\ \hline A 这里可以写很长的文字会自动换行 测试 \\ \hline \end{tabularx} \end{table}{\textwidth}表示表格总宽等于正文宽度X列会自动分配剩余宽度并换行。列宽的比例可以用{\hsize1.5\hsize}X这类写法调整不过大部分场景不需要这么精细。如果表格特别宽需要横过来放可以用rotating宏包的sidewaystable环境。如果表格跨页用longtable。这三个宏包覆盖了 90% 的表格需求。7.3 数学公式和符号查找行内公式用$...$独立编号公式用equation环境\begin{equation} f(x) \int_{-\infty}^{\infty} \hat{f}(\xi) e^{2\pi i \xi x} \, d\xi \label{eq:fourier} \end{equation}多行对齐用align\begin{align} a b c \\ d e \end{align}符号查找是个高频需求。希腊字母是\alpha、\beta、\Gamma这种命名规则大小写靠首字母大小写区分。但很多符号的命名不是那么直观比如\partial是偏导符号\nabla是梯度算符\infty是无穷。这时候就需要查符号表两个我常用的资源CTAN 上的symbols-a4.pdf一个把所有符号按类别排列的 PDF能直接搜以及一些在线的 LaTeX 符号查询网站输入求和积分这类中文能搜到对应的命令。圈和括号这类符号有个小坑直接用(和)在公式里高度是固定的如果括号里是分数或者矩阵括号会显得太小。这时候要用\left(和\right)它们会根据内容自动调整高度。左小括号的命令是\left(注意必须成对出现左右两端要匹配。如果是从 Word 里复制过来的公式粘贴到 LaTeX 里是图片或者乱码需要手动转写。有个技巧是用 Word 自带的转换功能先把公式转成 OMML再用第三方工具转 LaTeX但转换结果经常有瑕疵复杂公式还是手敲更快。7.4 套用学校或期刊模板的注意事项国内高校的学位论文模板基本都是book或report文档类加大量定制。拿到模板后有几件事必须确认。先看模板的 README 或者说明文档。里面通常会写清楚用什么引擎编译、需要哪些额外字体、有没有特殊的编译顺序。我见过有模板要求先跑 bibtex 再跑 xelatex顺序错了文献列表就是空的。先原样编译一遍。不要一上来就改内容先用模板自带的示例文档跑通确认环境没问题。这一步能帮你区分是环境问题还是是我改出的问题。注意字体依赖。有些学校的模板要求特定的中文字体比如学校定制的字体文件这些字体可能不随系统提供需要单独安装。如果是这种情况模板包里一般会附带字体文件按说明装到系统字体目录就行。别随意升级宏包。如果模板在某个时间点编译正常之后突然报错很可能是你中途更新了宏包导致不兼容。这种情况下先确认用tlmgr把相关宏包降回旧版本能否恢复再考虑改模板。写论文期间我一般会关掉自动更新等论文提交完再统一升。8. 我在多次重装里攒下的几条经验装 LaTeX 这件事我前后在 Windows、macOS、Ubuntu 上捣鼓过不下十次有些教训是只有踩过才知道的。第一装之前先把杀毒软件和实时防护关掉。TeX Live 安装过程中要写几万个文件某些安全软件会逐个扫描能把原本 40 分钟的安装拖成两个多小时还有小概率把宏包文件误判拦截。装完再打开就行。第二seriously 建议装完整版。我早期为了省两三个 G 装过 BasicTeX结果在写一篇带 TikZ 画图的论文时断断续续用tlmgr install补了二十多个宏包每次补完还要重编译看缺不缺下一个那个下午的体验非常糟糕。硬盘空间是这个时代最不稀缺的资源别在这上面省。第三给项目建一个独立的文件夹里面按章拆文件。论文写长了之后一个.tex文件几万行编辑器卡得打不开。用\include{chapter1}把每章拆开主文件只保留导言区和\include语句。这样编译时只编译改动的部分\includeonly速度能快不少。第四准备一个干净的最小可复现示例MWE。遇到奇怪报错时不要在主文档里瞎改新建一个只有几行的.tex文件把出问题的代码片段复制进去看能不能复现。能复现就继续删代码直到最小然后拿着这个最小例子去论坛提问你会得到完全不同的响应速度。这个习惯帮我解决过好几次玄学问题——最后发现是某个宏包跟另一个宏包的加载顺序冲突在主文档里根本看不出来。第五也是最后一条别怕命令行。很多新手习惯全程用图形界面遇到问题靠猜。其实xelatex、tlmgr、latexmk、kpsewhich这几个命令加起来不到十个常用参数花半小时熟悉一下排查问题的效率会有质的提升。kpsewhich尤其有用它能直接告诉你某个文件到底在不在你的发行版里、在哪个路径下判断是没装还是没找到只需要一秒钟。装 LaTeX 这件事本身不难难的是第一次遇到报错时不知道该往哪个方向查。把发行版、引擎、编辑器这三层的职责分清楚把 xelatex 设成默认编译器把源换成国内镜像剩下的问题基本都能靠读日志解决。环境一旦通了它带来的收益是长期的——你写过的每一个公式、每一张表、每一篇论文都在同一个稳定的体系里不用再为格式操心。