折腾 LaTeX 这件事很多人卡住的不是语法而是最开始那一步TeXLive 装不上、TeXStudio 找不到编译器、中文编不出来、报错了不知道错在哪一行。我前后给三台机器装过这套组合Windows 上有Mac 上也有中间踩过的坑基本覆盖了新手能遇到的全部情形。这篇文章就围绕TeXLive TeXStudio这套最经典、最稳的本地 LaTeX 环境来讲从下载安装、编译器对接、中文支持一路讲到日常写作里最高频的语法动作、报错定位方法以及期刊模板、VSCode 替代方案和 Word 公式互转这些延伸需求。不管你是完全没碰过 LaTeX 的小白还是装过一次但没跑通的半新手都能在下面找到对应的操作路径文中给出的命令和配置都可以直接抄过去改路径就能用。1. 先想清楚为什么是 TeXLive 加 TeXStudio 这个组合很多人一上来就搜latex下载安装教程然后被一堆名词砸晕MiKTeX、TeXLive、CTeX、WinEdt、TeXStudio、TeXworks、VS Code、Overleaf……到底装哪个先把这一层理清楚后面的操作才不会来回返工。1.1 发行版和编辑器是两回事这是新手最容易混淆的一点。LaTeX 本身只是一套排版格式的定义它需要一个发行版来提供底层的排版引擎和成千上万个宏包同时需要一个编辑器来给你提供写代码的界面。发行版TeXLive、MiKTeX 是两大主流。TeXLive 跨平台、宏包齐全、版本一年一更、期刊投稿环境基本都以它为准MiKTeX 的优势是按需下载宏包装得快但联网依赖强遇到内网或者网络不稳的时候就比较难受。编辑器TeXStudio、TeXworks、WinEdt、VS Code 都属于这一类。它负责的只是高亮、补全、一键编译、PDF 预览这些事本身不参与排版。所以安装 LaTeX这句话拆开就是装一个发行版提供引擎再装一个编辑器提供界面然后把两者接起来。TeXLive TeXStudio 就是这套拆法里最省心的组合。1.2 为什么我推荐 TeXLive 而不是按需下载的方案我最早用的是按需下载的那套刚开始确实爽几百兆就装完了打开就能写。但问题出在第一次用别人的论文模板时模板里引用了十几个宏包编译一次弹一次下载框网络稍微抖一下就要重来最要命的是不同机器上下载到的宏包版本可能不一致同一份文档在家里能编、在实验室编不出来。TeXLive 的完整安装大概是几个 GB装的时候慢但换来的是一次装好、后续所有宏包都在本地。它的发行节奏是每年一个新版本比如 texlive2023、texlive2024版本期内宏包相对固定文档的可复现性非常好。投稿期刊、写毕业论文这种不能出意外的场景本地宏包齐全这一点比什么都重要。另外一点是命令行工具的一致性。TeXLive 提供的tlmgr包管理器、latexmk自动编译工具、xelatex、biber这些命令在 Windows、macOS、Linux 上参数完全一样你换电脑的时候不用重新学一套。1.3 TeXStudio 相比其他编辑器的取舍TeXStudio 不是最漂亮的编辑器界面甚至有点老旧但它有个别人比不了的优势对 LaTeX 工作流的理解最完整。它内置了公式预览、符号面板、参考文献补全、结构树、一键跳转到 PDF 对应位置正反向搜索还有那个救过很多人的错误定位——编译失败时能把日志里的错误行号直接标在源码上。WinEdt 要收费TeXworks 功能太素VS Code 则要自己配一堆插件才达到同等体验第 7 节会专门讲 VS Code 的方案。所以我的建议是主力用 TeXStudio 把活干完VS Code 作为补充尤其是当你已经习惯用 VS Code 写代码的时候。2. TeXLive 安装全过程镜像、路径与中文用户名这道坎这一段是整篇文章里最物理的一步也是最容易失败的一步。我把它拆成下载、参数选择、路径处理三块来讲。2.1 下载选对镜像能省一半时间TeXLive 官方主站的下载速度在国内经常是龟速几个 GB 的东西下到一半断了要重来非常折磨。正确的做法是用国内的镜像站下载。常见的高校镜像清华、中科大、阿里等都有 TeXLive 的完整镜像目录进入之后一般能看到install-tl-windows.exeWindows 网络安装器或者texlive.iso离线镜像。我的建议是方式体积适合场景注意事项网络安装器install-tl-windows.exe引导程序约 20MB实际拉几个 GB网络稳定、想装最新宏包安装过程全程联网中途断网要重来离线 ISO约 4–5GB网络不稳、要给多台机器装下载完要挂载或解压再运行里面的安装脚本提示如果只是单机安装直接下网络安装器最省事但如果你要给实验室好几台机器装或者担心安装过程中网络波动离线 ISO 更稳装的时候完全不需要联网。下载完别急着双击。先确认一下磁盘空间完整安装加上后续生成的临时文件预留 12GB 以上比较舒服如果选了 full 方案会更大。2.2 安装参数哪些选项值得点启动安装器之后会进入一个字符界面或图形界面Windows 上通常是图形界面。关键选项有这几个安装方案scheme新手建议选scheme-full一次装全省得以后缺宏包。如果硬盘真的紧张选scheme-medium也行后续缺什么用tlmgr install 包名补。安装路径默认是C:\texlive\2024这类路径。这个路径尽量不要带中文和空格。用默认路径就挺好想装到 D 盘也行但路径要保持纯英文。纸张大小默认 A4 就行选 Letter 的话某些中文模板排版会出现奇怪的边距。创建指向命令的软链接 / 加入 PATH这个一定要勾。它决定了你之后能不能在任意命令行窗口直接敲xelatex。安装时间上完整方案在普通机械硬盘上可能要 40 分钟到 1 小时固态上大概 15–25 分钟主要瓶颈是几万个小文件的写入。这段时间去做别的事别以为卡死了。2.3 Windows 用户名是中文时会发生什么这是我最想重点讲的一条因为搜索引擎里果 windows 用户名是中文安装 texlive这类词被反复搜说明踩坑的人特别多。现象是这样的安装器启动后闪退或者进度条走到某个位置报一个看不懂的错误又或者装完之后一编译就提示找不到文件、路径乱码。根本原因是TeXLive 的安装器会把临时文件解压到用户目录下通常是C:\Users\你的用户名\...或者系统的临时目录而 LaTeX 工具链里有一部分程序对非 ASCII 字符的路径处理得并不好。中文用户名、带空格的用户名、带特殊符号的用户名都可能触发这个问题。有三种解决办法按推荐程度排列新建一个纯英文名的本地账户登录这个账户再装。这是最干净的做法装完之后你原来的账户能不能用能因为 TeXLive 默认装在C:\texlive\2024是全机共享的只要 PATH 配置对了其他账户也能调起来。改变临时目录。在启动安装器之前先手动改环境变量把TEMP和TMP指向一个纯英文路径比如D:\tmp。然后再运行安装器。这是一个临时规避装完系统环境变量记得改回去。用离线 ISO 手动解压安装。解压到一个纯英文目录比如D:\texlive2024-install再运行里面的安装脚本这样能绕开一部分临时目录的问题。注意不管用哪种办法安装完成后你的所有.tex文件所在的文件夹路径也尽量保持纯英文。我见过有人把论文放在我的文档\毕业论文里编译时图片死活找不到折腾一个小时才发现是路径里的中文在作祟。装完之后验证一下新开一个命令行窗口敲tex --version xelatex --version tlmgr --version三条命令都能正常输出版本号就说明发行版这一层好了。如果提示不是内部或外部命令说明 PATH 没配好需要手动把C:\texlive\2024\bin\windows注意 Windows 下是这个子目录加进系统 PATH。3. 让 TeXStudio 认出 TeXLive编译器配置与常用选项TeXStudio 是独立安装的它和 TeXLive 之间靠命令路径来对接。装完 TeXLive 之后再装 TeXStudio通常它能自动检测到但有几项设置我每次都会手动过一遍。3.1 首次启动必须改的几项设置打开 TeXStudio先进入选项 → 设置 TeXStudio重点看这几处命令Commands这里能看到LaTeX、PdfLaTeX、XeLaTeX、LuaLaTeX、BibTeX、Biber各对应哪个可执行文件。如果显示的是xelatex这种相对路径说明它已经通过 PATH 找到了如果显示为未设置或者空白就要手动填绝对路径比如C:/texlive/2024/bin/windows/xelatex.exe。注意斜杠方向这里用正斜杠或者双反斜杠都行。构建Build把默认编译器改成XeLaTeX中文文档必改原因见第 4 节把默认的参考文献工具改成Biber如果你用biblatex或者保持BibTeX如果你用传统的.bib\bibliography。编辑器Editor字体换成等宽字体行号打开自动换行可以关掉——LaTeX 源码一行就是一行自动换行反而容易看不清结构。语法高亮默认配色就够用如果你长时间看屏幕可以把背景改成浅灰比纯白舒服。3.2 一键编译怎么配才不闹心TeXStudio 底部有一排按钮最常用的是那两个一个绿色箭头构建并查看、一个红色叉停止编译。默认的 F5 是构建并查看F6 是只编译不预览F7 是查看 PDF。中文文档的常见问题是参考文献和交叉引用不更新编译一次引用全是问号。这是因为 LaTeX 的多趟编译机制第一次编译生成.aux文件第二次才能把引用填进去有参考文献还要跑 BibTeX/Biber然后再编两趟。我一般会在选项 → 设置 TeXStudio → 构建里把默认编译方式设成一个自动判断的模式或者干脆用latexmk。latexmk会自己判断要跑几趟、要不要跑 BibTeX省心很多。配置方式是在构建命令里加一个自定义命令latexmk -xelatex -synctex1 -interactionnonstopmode %.tex其中-xelatex指定引擎-synctex1生成正反向搜索需要的信息-interactionnonstopmode让编译遇到错误不要停下来等你敲回车否则自动化编译会卡死%.tex是 TeXStudio 的占位符代表当前文件。3.3 中文词典与拼写检查TeXStudio 默认的拼写检查是英文词典写中文文档的时候满屏红波浪线看着非常烦。解决办法有两个一是直接关掉拼写检查在选项 → 设置 TeXStudio → 拼写检查里把检查拼写取消勾选。适合纯中文文档。二是添加中文词典TeXStudio 用的拼写检查引擎支持加载额外的.dic词典文件。把下载好的中文词典文件放到 TeXStudio 的词典目录下在设置里选择对应的语言就能对中文做检查主要是查错别字效果有限但能减少红波浪线。实际操作上更常见的做法是只对英文部分开启检查把中文段落用注释或者配置排除掉。另外一个实用小设置\cite{}、\ref{}这些命令的参数里出现的中文也可能被误判可以在拼写检查的忽略列表里加上命令名。4. 中文文档能不能编译出来编码、字体与引擎第 3 节里提到中文文档把编译器改成 XeLaTeX这里解释为什么。4.1 为什么默认引擎编不出中文LaTeX 最老的引擎叫latex它输出的是 DVI 文件本身对字体编码的处理非常原始处理中文要靠CJK宏包加上一堆位图字体效果惨不忍睹。后来有了pdflatex它能直接出 PDF但对 UTF-8 编码的中文支持依然要通过CJKutf8这类宏包绕配置麻烦且容易出问题。xelatex和lualatex是新一代引擎原生支持 UTF-8能直接调用系统里安装的字体通过fontspec宏包。这才是现在写中文文档的正确姿势。所以你在任何模板里看到\setmainfont{}、\setCJKmainfont{}这类命令基本可以确定它要求用 XeLaTeX 编译。4.2 ctex 宏包和文档类怎么选最省事的中文方案是ctex系列\documentclass[UTF8]{ctexart} \begin{document} 你好世界。 \end{document}ctexart是文章类还有ctexrep报告、ctexbook书。如果你用的是标准类比如article就在导言区加一行\usepackage[UTF8]{ctex}这两种写法的区别是ctexart已经把中文排版的各种参数段落缩进、标题字体、行距都调好了适合从零开始写\usepackage{ctex}则会覆盖一部分标准类的设置适合套用英文模板时临时加中文支持。注意ctex宏包会自动调用系统的中文字体。Windows 下它默认找的是宋体、黑体、楷体这些macOS 下换成华文系列。如果你在 Linux 上编译很可能因为系统没装这些字体而报字体找不到这时候要么装字体要么在导言区显式指定字体名。4.3 字体缺失、乱码、方框字的处理三种典型症状和对策编译通过但 PDF 里中文全是方框说明字体没被正确嵌入或者指定了一个系统里不存在的字体。检查导言区有没有硬编码字体名把字体名换成系统里确实存在的。报错Font SimSun not foundWindows 上一般是字体名写错了应该用SimSun对应宋体或者用中文名宋体。macOS 上对应的字体名完全不同。编码乱码确认源文件保存为 UTF-8。TeXStudio 默认就是 UTF-8但如果你是从 Word 或者旧编辑器里复制过来的内容可能带上了 GBK 编码的字符这时候要另存为 UTF-8。还有一个隐蔽的问题某些宏包会改变字体设置。比如你引入了某个期刊模板它内部重定义了\songti、\heiti这些命令结果和你自己设置的字体冲突。遇到字体相关的怪现象先看看模板里有没有类似的字体声明。5. 真正写起来才会用到的高频语法环境配好之后就是日常写作。这一节挑的是搜索量最高、也最容易搞错的那几个点。5.1 换行、分段、空行这些低级问题latex 换行符怎么打是个高频问题因为它的答案和大家的直觉不一样。核心规则就一句话LaTeX 里空行代表分段单个换行不代表任何东西。你在源码里敲一次回车渲染出来还是同一段敲两次回车中间留一个空行才是新起一段。如果只想换行但不想分段比如写地址、写诗歌用双反斜杠第一行 \\ 第二行要强制分段且不要缩进用\par \noindent 这一行不缩进细分一下这几个命令的区别命令效果常用场景空一行新起一段首行缩进正文自然分段\\强制换行不缩进不分段表格内、地址、诗歌\newline同上语义更明确一般等价于\\\par强制分段宏定义内部\noindent取消本段首行缩进摘要、列表后的段落\clearpage分页并强制输出浮动体章节结束处还有个常见误区有人想在段落之间多留一点空白就狂敲空行。这是无效的多个空行和一个空行效果一样。要控制段间距应该用\setlength{\parskip}{0.5em}这类设置。5.2 数学公式与希腊字母行内公式用单个美元符号包起来$E mc^2$。独立成行的公式用双美元符号旧写法不推荐或者更规范的\[ ... \]\[ \int_{-\infty}^{\infty} e^{-x^2}\,dx \sqrt{\pi} \]需要编号的公式用equation环境多行对齐用align都要在导言区加\usepackage{amsmath}\begin{align} a^2 b^2 c^2 \\ \sin^2\theta \cos^2\theta 1 \end{align}希腊字母是另一大高频需求。规律很简单小写希腊字母用\字母名大写的话首字母大写即可但有几个例外大写的 Alpha、Beta 等其实直接打英文 A、B 就行因为它们的形状和拉丁字母一样。小写代码大写代码α\alphaΓ\Gammaβ\betaΔ\Deltaγ\gammaΘ\Thetaθ\thetaΛ\Lambdaλ\lambdaΣ\Sigmaμ\muΦ\Phiσ\sigmaΨ\Psiω\omegaΩ\Omega其他常用符号\times乘号、\cdot点乘、\pm正负、\leq、\geq、\neq、\approx、\in、\subset、\sum、\prod、\partial、\nabla。记不住的时候TeXStudio 左侧有个数学符号面板点一下就插进去了比查表快。提示公式里的空格会被忽略想加一点视觉间距用\,小、\:中、\;大。公式里的文字要用\text{}包起来否则会变成斜体的变量连排。5.3 插入图片与浮动体插入图片的标准写法导言区需要\usepackage{graphicx}\begin{figure}[htbp] \centering \includegraphics[width0.8\textwidth]{figures/result.png} \caption{实验结果对比图} \label{fig:result} \end{figure}几个要点[htbp]是浮动位置的建议依次表示 here、top、bottom、page。LaTeX 会根据自己的规则决定不是你说了就算。如果图片跑到很后面去了可以用[H]需要float宏包强制钉在这里。width0.8\textwidth表示宽度占正文宽度的 80%比写死厘米数更适应不同模板。\label要写在\caption后面否则交叉引用会指错。引用的时候用\ref{fig:result}得到编号用\autoref{}能得到图 1这种完整形式。图片路径里的文件名不要有中文和空格这是前面反复强调的坑。文件名也别用大写字母混排容易在不同系统上出问题。5.4 表格自动换行latex 表格自动换行这个问题背后是标准tabular环境的一个硬伤l、c、r这些列格式不支持自动换行列宽由内容撑开一不小心就冲出页面边界。三种解决思路方案一用p{}指定宽度p{3cm}这种列会自动换行但它是左对齐的要居中得配合\centering。方案二用tabularx宏包它提供一个X列类型会自动分配剩余宽度并且换行\usepackage{tabularx} \begin{tabularx}{\textwidth}{|X|X|X|} \hline 方法 优点 缺点 \\ \hline 方法一 实现简单 精度较低 \\ \hline \end{tabularx}方案三用makecell宏包它提供\makecell{}可以在单元格内部手动换行\usepackage{makecell} \begin{tabular}{|c|c|} \hline \makecell{第一行\\第二行} 内容 \\ \hline \end{tabular}实测下来表格宽度固定的就用方案三需要按比例自适应的用方案二。方案一很少单独用因为居中处理比较麻烦。6. 编译报错时怎么快速定位到出问题的那一行搜索引擎里latex 不能运行时怎么知道哪个地方错误这个问题说明很多人被报错信息吓住过。其实 LaTeX 的报错定位能力比想象中强关键是知道去哪看。6.1 读懂日志文件的结构TeXStudio 底部的日志面板显示的是编译输出但它的信息是截断的、混杂的。真正的定位要去看.log文件和.tex文件同目录文件名相同。日志文件的结构大概是这样的前几十行是引擎版本、加载的宏包列表不用看。中间开始出现加载各个宏包的过程如果某个宏包加载失败这里会提示。报错从第一个以!开头的行开始。LaTeX 的报错会级联第一个错误往往引发后面几十个错误所以只看第一个!就够了。紧接着!的几行是错误描述然后会有一行l.123这样的信息这就是出错的行号。再往后会有几行上下文显示出错位置前后的内容。举个例子! Undefined control sequence. l.42 \alfha意思是第 42 行用了一个没定义过的命令\alfha显然是把\alpha拼错了。这种错误一眼就能改。6.2 几类最常见的报错与处理报错信息常见原因处理方式Undefined control sequence命令拼错或没加载对应宏包检查拼写补\usepackageMissing $ inserted数学符号写在了公式环境外面用$...$包起来或检查漏掉的$File xxx.png not found图片路径错、文件名有中文、扩展名写了两次检查路径和文件名Runaway argument花括号不配对顺着报错行往上找补齐{}Font ... not found字体名写错或系统没装换字体名或安装字体Emergency stop某个严重错误导致中断看它前面第一个!Too many }s右花括号多了检查附近环境嵌套6.3 用二分法把问题逼出来有些错误不报行号或者报的行号明显不对比如指向文档最后一行这时候要上二分法。操作很简单把文档从中间一刀切开注释掉后面一半用%或者\iffalse ... \fi包起来编译一次。如果错误还在说明问题在前半部分再从前半部分中间切一刀。如果错误消失说明问题在后半部分把后半部分恢复前半部分注释掉。这样最多十几轮就能把出错范围缩到几十行然后人眼扫一遍基本就能找到。这个方法看起来笨但比盯着满屏红字发呆快得多。还有一个实用技巧把可疑的环境、宏包逐个注释掉。尤其是当你引入了新宏包之后突然坏了基本就是宏包冲突一个一个试很快就能定位。注意.log文件在编译失败后依然会生成所以哪怕编译中断了日志也是有的。TeXStudio 里可以右键日志区域选择打开日志文件直接定位到文件。7. 模板、VSCode 与 Word 公式互转这些延伸需求前面的内容能让你把环境跑起来、把文档写出来。这一节处理的是实际工作里绕不开的几个延伸场景。7.1 期刊模板怎么用投中文期刊比如计算机学报这类通常编辑部会提供一个压缩包里面是.cls文档类、.bst参考文献样式、示例.tex和说明文档。使用步骤把模板里的.cls、.bst、.sty全部和你的.tex放在同一个目录。打开示例.tex把里面的正文替换成你自己的内容不要删掉导言区。看说明文档确认要求什么引擎。中文期刊模板绝大多数要求XeLaTeX因为要用中文字体。看参考文献用的是什么方式。老模板用\bibliographystyle{}\bibliography{} BibTeX新模板用biblatex Biber。两者的编译流程不同配错了参考文献就不出来。我踩过的一个坑是模板要求 XeLaTeX但 TeXStudio 的默认编译器是 PdfLaTeX结果编译出一堆字体错误还以为是模板坏了。拿到任何模板的第一件事先找找有没有README或者说明确认引擎。另一个坑是模板自带的字体设置和你系统的字体不匹配。比如模板里写了\setCJKmainfont{SimSun}而你系统里字体名是宋体那就要改。最稳的办法是把模板里的字体设置改成用ctex默认或者用一个通用字体名。7.2 VSCode LaTeX Workshop 的配置如果你日常用 VS Code 写代码把它当 LaTeX 编辑器是完全可行的核心插件是LaTeX Workshop。最关键的配置在settings.json里主要是定义编译配方{ latex-workshop.latex.recipes: [ { name: xelatex, tools: [xelatex] }, { name: xelatex - bibtex - xelatex*2, tools: [xelatex, bibtex, xelatex, xelatex] } ], latex-workshop.latex.tools: [ { name: xelatex, command: xelatex, args: [ -synctex1, -interactionnonstopmode, -file-line-error, %DOC% ] }, { name: bibtex, command: bibtex, args: [%DOCFILE%] } ] }几个容易忽略的点-file-line-error这个参数很重要它能让报错输出格式变成文件:行号: 错误VS Code 就能直接点击跳转到出错行这是 LaTeX Workshop 定位错误的关键。中文路径问题同样存在工作区路径要纯英文。预览 PDF 默认是在 VS Code 内部标签页打开如果觉得卡可以配成调用外部阅读器比如 SumatraPDF支持正反向搜索点 PDF 跳回源码。latexmk也可以用配一条latexmk -xelatex的 tool 就行比手动串联多趟编译更省心。VS Code 相比 TeXStudio 的优势是插件生态和代码编辑体验劣势是要自己配而且默认的 PDF 预览体验不如 TeXStudio 流畅。我个人的用法是写论文用 TeXStudio写带代码的项目文档用 VS Code。7.3 Word 公式与 LaTeX 互转这是很多人关心但很少有人讲清楚的一块。分两个方向。LaTeX 转 WordWord 从某个版本开始自带公式编辑器支持 LaTeX 输入模式。你可以在插入公式之后在公式工具栏里切换成LaTeX输入方式然后把 LaTeX 公式粘贴进去按一下转换就能渲染成 Word 公式。注意一点Word 的 LaTeX 模式只支持公式本身不支持\begin{equation}这类环境所以你粘进去的应该是纯公式内容比如\frac{a}{b}而不是带环境的完整代码。如果粘进去显示不正常检查一下是不是把中文或者环境命令也带进去了。Word 转 LaTeX如果你有一份 Word 文档里全是公式想转成 LaTeX手动敲太痛苦。可行的路径是用转换工具比如 pandoc 把 Word 转成 Markdown 或 LaTeX然后手动整理公式或者用专门的公式OCR工具截图转 LaTeX。转出来的结果通常需要人工校验尤其是多行公式和矩阵。一个实践中的经验如果是自己写的文档最好从一开始就用 LaTeX 写公式别先写 Word 再转因为来回转换的格式损失比重新写一遍还费时间。如果是必须处理别人给的 Word那就先转成纯文本把公式位置标记出来再逐个处理。我用这套组合写论文、写技术文档、做课程作业已经好几年了。回头看最值得花时间去搞清楚的其实只有三件事安装时避开中文路径这个坑、中文文档一律用 XeLaTeX、报错时只看日志里第一个感叹号。这三件事搞明白剩下 90% 的问题都能自己解决剩下的 10% 靠搜索和二分法也能搞定。至于那些花哨的宏包和排版技巧用的时候再学完全来得及。