排版这件事平时不痛不痒真到了要交三十页毕业论文、或者投一份格式要求苛刻的期刊稿件时才会发现 Word 那套“所见即所得”的思路有多让人抓狂插图一挪位置就跑公式编号手动改到怀疑人生参考文献格式换一本期刊就得重排一遍目录页码刷半天刷不出来。LaTeX 就是冲着这些场景来的它本质是一套论文排版工具你用纯文本写内容、打标记剩下的字体、行距、编号、交叉引用、参考文献格式交给一套排版引擎自动算。它不神秘也不是学术圈的门槛只是一个把“排版”和“写作”彻底拆开的工具。这篇东西我按自己带师弟师妹的流程来写先讲清楚 LaTeX 到底在干什么、编译链是怎么跑起来的再给出一套 Windows 下从头到尾的安装教程然后是编辑器配置、语法最小可用集、论文模板怎么改最后是我这几年攒下来的报错速查表。安装教程部分我以 TeX Live 完整版为主线它是目前兼容性最稳、坑最少的一条路使用教程部分不会把宏包文档抄一遍只讲你写论文真正会用到的那二三十个命令。完全没碰过命令行的本科生能照着走完用过一阵子的人也能在里面翻到几条能省时间的配置。1. 先搞懂 LaTeX 到底在做什么1.1 内容和排版分离这才是核心Word 的思路是“你看到什么就是什么”你敲字的时候顺手调格式格式和内容搅在一起。写三页的文档没问题写三千页的文档就完蛋。LaTeX 的思路反过来你只负责写内容并打上语义标记比如“这里是二级标题”“这里是一张图片”“这里要引用文献 3”具体二级标题该用多大字号、图片该浮到哪里、文献 3 该显示成 [3] 还是 (Zhang et al., 2023)全由样式文件决定。这个差别带来的最大好处不是“好看”而是一致性可以被机器保证。你论文里有一百三十处交叉引用改动了章节顺序之后编号会自动重算你有一百二十条参考文献换一个期刊模板全文引用格式一次性重排你一个字母都不用动。我在实际使用中发现真正让人回不去 Word 的就是这一点。还有一个隐性优势.tex文件是纯文本。这意味着你可以用 Git 做版本管理可以 diff 出“这次改了什么”可以多人协作时靠合并工具解决冲突。相比之下.docx是压缩包里的二进制 XML冲突了基本只能靠人力肉眼比对。1.2 一次编译到底发生了多少次“搬运”很多人第一次用 LaTeX 会困惑为什么目录是空的为什么引用显示成??为什么非要编译两遍答案在编译链里。一次完整的编译通常涉及四个程序接力程序作用产物xelatex或pdflatex读取.tex生成排版结果.pdf、.auxbibtex或biber读取.aux里的引用需求去.bib数据库取数据.bblxelatex第二遍读.bbl把参考文献排进去更新的.auxxelatex第三遍读取上一遍写入的页码、编号填进目录和引用最终.pdf.aux这个中间文件是关键它相当于排版引擎留给自己的便签本目录里每个章节在第几页、每个\label对应什么编号全都写在这。所以目录空、引用问号、公式编号乱九成情况是编译次数不够不是代码写错了。理解了这一层后面排查问题会轻松很多。顺带说一句latexmk。它是个自动化脚本会根据.aux的依赖关系自动判断该跑几遍、要不要跑 bibtex。用上它之后你只需要按一次编译键这也是下面编辑器配置里我强烈推荐用它做默认工具的原因。1.3 什么情况该上 LaTeX什么情况别硬上不是所有文档都值得用 LaTeX。我个人的判断标准是三条数学公式密度高一篇文档里超过二十个公式或者需要多行对齐、矩阵、分段函数LaTeX 的收益立刻拉开差距。格式要求由外部规定期刊、学位论文有模板你不想跟格式要求较劲那就用模板。文档规模大且结构复杂章节多、图表多、交叉引用多、参考文献多涉及反复修改。反过来如果是给同事发的一份周报、一份产品需求文档、一张带排版的简历用 LaTeX 就是自找麻烦Word 或者在线文档二十分钟搞定的事没必要配置环境。我见过有人为了做一份两页的社团通知折腾一下午 TeX 环境这个性价比实在不高。2. 安装方案选型三条主流路线怎么挑2.1 三个发行版的能力对比所谓“安装 LaTeX”准确说法是安装一个 TeX 发行版。发行版 排版引擎 几万个宏包 字体 辅助工具打包在一起。主流选择有三个发行版平台安装体积更新策略适合谁TeX LiveWindows / Linux / macOS完整版约 7–8 GB年度版本可在线更新宏包首选兼容性最好模板作者一般都拿它测MiKTeXWindows / macOS / Linux初始约 200 MB用到哪个宏包下载哪个硬盘紧张、或者只做轻量文档MacTeXmacOS约 6 GB本质是 TeX Live 的 Mac 封装Mac 用户装了就等于装了 TeX Live我给你一个不太“官方”但很实在的建议只要是正儿八经写论文直接 TeX Live 完整版。MiKTeX 的按需下载听起来很香但它的代价是编译过程中可能突然弹窗或卡住去下宏包网络不好的时候编译速度会被拖得很难受更麻烦的是很多学位论文模板依赖一些冷门宏包第一次编译满载下载报错信息还容易被下载日志淹没。2.2 关于“latex 下载”这件事先把来源搞清楚搜索引擎里搜“latex 下载”排在前面的往往是一些第三方站的“绿色版”“精简版”“免安装便携版”。我的建议很明确只从发行版官方渠道下载。原因有三个第一TeX 系统里有大量可执行文件从不明来源拿来的安装包你没法确认里面有没有被塞进别的东西。第二精简版通常砍掉了字体和文档你后面遇到File xxx.sty not found之类的报错原因就是被砍掉了你还要花时间补回来。第三这些版本更新频率低宏包版本老遇到新模板直接编译不过。下载的时候注意一件事用镜像站。官方主站的下载速度在某些时段会非常慢国内几个高校和镜像站点都有完整同步用镜像下载能把几个小时压到十几分钟。安装器里也内置了镜像选择安装中途可以切换。2.3 先把磁盘和时间的预算算清楚在动手之前先把这两个数字看清楚免得装到一半发现空间不够磁盘完整安装约 7–8 GB加上后续更新和临时文件建议预留 15 GB 以上。装在机械硬盘上编译大文档会明显慢有条件放固态。时间网络顺畅的情况下完整安装 20–40 分钟网络一般的话一两个小时也正常。这个过程可以干别的事但别关电脑。还有一个容易被忽略的点安装路径不要带中文和空格。像D:\我的论文\texlive或者D:\Program Files\texlive这种某些宏包在处理文件路径时会出问题报错信息还很难懂。用D:\texlive\2024这种干净路径能避开一大类莫名其妙的故障。3. Windows 下 TeX Live 安装完整实操3.1 下载安装器与镜像选择打开 TeX Live 官方页面下载install-tl-windows.exe。这个 exe 其实是个引导器运行后会先连网下载真正的安装程序。双击之后会出现两个选项Simple / 简易安装一键装完整版几乎不需要做选择。Advanced / 高级安装可以自定义组件、路径、镜像。我一般选高级安装理由有三个能改安装路径默认路径难记、能选镜像决定下载速度、能关掉一些用不上的语言包省空间。安装器界面左侧有一个Directories区块把TEXDIR改成你准备好的干净路径比如D:\texlive\2024。镜像选择在安装器界面上部有个下拉框一般会自动测速。如果自动选中的那个下载速度很慢进度条半小时不动手动换一个。判断标准很简单看剩余时间估计如果超过三个小时就换。3.2 安装选项逐项拆解进入高级安装之后会看到一堆组件勾选框容易让人懵。按我的习惯这样处理Scheme安装方案选full也就是完整安装。不要选basic或者medium理由前面说过。Language collectionsChinese、Chinese/Japanese/Korean这两个可以留着中间有中文排版要用的东西。TeXworks editor可以留着装完先拿它验证环境能不能跑通后面换 VS Code。Install TeX Live documentation这个会多占一两个 GB如果你习惯本地查文档就留着主要靠在线查的话可以取消。Create symlinks之类的选项在 Windows 上一般不需要动。参数确认之后点安装剩下的就是等。安装过程中有一个细节值得注意关闭杀毒软件的实时扫描或者把安装目录加进白名单。TeX Live 会在短时间内释放几十万个小文件实时扫描会把这个过程拖得非常慢我遇到过装了两小时才装完一半的情况加白名单之后 25 分钟结束。注意安装过程中不要中途强退。TeX Live 的安装不是原子操作中断之后目录可能处于半成品状态重新安装时容易因为残留文件报错。真需要中断先把整个安装目录删干净再重来。3.3 装完必须做的三项验证安装器跑完最后一步会打印一行提示告诉你哪些环境变量已经设置好。很多人到这里就直接开编辑器了结果一堆“命令找不到”的报错。我建议先做三项验证命令行里敲xelatex --version bibtex --version latexmk --version三行都能打印出版本号说明 PATH 配好了。如果提示“不是内部或外部命令”有两个可能一是安装时没勾选创建环境变量二是你当前开着命令行窗口而 PATH 是在窗口打开之后才修改的需要关掉重开。老版本的 Windows 需要重新登录一次才能生效。第二项验证写一个最小文档编译一次。新建test.tex\documentclass{article} \begin{document} Hello, \LaTeX. \end{document}在命令行里cd到文件所在目录执行xelatex test.tex同目录下应该出现test.pdf。这一步跑通说明引擎可用。第三项验证tlmgr能连上镜像。执行tlmgr update --self如果能正常列出更新信息说明后续可以自己维护宏包。这一步很多人跳过等到半年后模板需要新宏包时才发现更新不了还得重新排查。4. 编辑器怎么选怎么配4.1 编辑器对比别在选型上纠结太久TeX Live 自带的 TeXworks 能用但功能比较基础。真正写论文我建议从下面几个里挑编辑器优势短板推荐度VS Code LaTeX Workshop生态好、配置可控、能和其他语言共用需要手写一段 JSON 配置最推荐TeXstudio开箱即用菜单里能改的东西多界面偏老大项目偶尔卡新手友好TeXworks装了就有零配置功能单薄没有正向反向搜索应急在线平台不装环境多人协作方便依赖网络大文件编译慢临时救急Vim / Emacs键盘流效率天花板学习曲线陡老手自便如果你已经装了 VS Code 并且常用那就别折腾了直接配 LaTeX Workshop一劳永逸。如果完全没接触过 VS CodeTeXstudio 的菜单式配置更省心。4.2 VS Code LaTeX Workshop 配置逐行说明先装两个东西VS Code 本体以及扩展市场里的LaTeX Workshop。装完之后打开设置切到 JSON 模式快捷键CtrlShiftP输入Open Settings (JSON)把下面这段贴进去{ latex-workshop.latex.recipes: [ { name: xelatex - bibtex - xelatex*2, tools: [xelatex, bibtex, xelatex, xelatex] }, { name: latexmk (xelatex), tools: [latexmk-xe] } ], latex-workshop.latex.tools: [ { name: xelatex, command: xelatex, args: [ -synctex1, -interactionnonstopmode, -file-line-error, %DOC% ] }, { name: bibtex, command: bibtex, args: [%DOCFILE%] }, { name: latexmk-xe, command: latexmk, args: [ -xelatex, -synctex1, -interactionnonstopmode, -file-line-error, %DOC% ] } ], latex-workshop.latex.autoClean.run: onBuilt, latex-workshop.latex.clean.fileTypes: [ *.aux, *.bbl, *.blg, *.idx, *.ind, *.lof, *.lot, *.out, *.toc, *.acn, *.acr, *.alg, *.glg, *.glo, *.gls, *.fls, *.log, *.fdb_latexmk, *.snm, *.nav ], latex-workshop.view.pdf.viewer: tab, latex-workshop.latex.autoBuild.run: onFileChange }逐项解释一下为什么这么写不然你以后改了配置出问题不知道怎么回退recipes是编译方案的组合。第一个方案面向中文论文走xelatex编译、bibtex处理文献、再补两遍xelatex填目录和引用。第二个方案用latexmk一次性搞定适合追求速度的日常编译。tools里每一项对应一条可执行命令。-synctex1是关键参数它让 PDF 和源码之间建立坐标映射你才能在 PDF 上点一下跳回源码、在源码里跳回 PDF 对应位置。-interactionnonstopmode保证遇到错误不弹交互提示否则无人值守编译会永久卡住。-file-line-error让报错信息带上文件名和行号排查效率翻倍。autoClean.run: onBuilt表示每次编译成功后自动清理中间文件。这个设置很有必要否则一个论文目录里会堆几十个.aux、.bbl、.log用 Git 提交的时候一片红。但要注意如果你要提交给期刊的源码包临时关掉这个设置因为有些期刊要求你连.bbl一起提交。这是个真事我帮人改模板时见过有人把所有中间文件清干净了结果对方编辑说缺少编译产物。view.pdf.viewer: tab让 PDF 在 VS Code 里的标签页中预览边写边看不用切窗口。4.3 中文排版为什么必须用 xelatex这是个高频困惑点为什么别人给的命令是pdflatex我配的却是xelatex简单类比pdflatex是个老式打字机它只认早期的字体格式处理中文需要走一堆转换流程xelatex是新一代引擎可以直接调用系统里装好的字体文件。你写中文论文只要在导言区加一句\usepackage{ctex}ctex宏包会自动帮你配置好中文字体、中文标点、章节标题的“第几章”字样、以及中英文间距。注意一个细节用ctex宏包时编译必须走 xelatex用 pdflatex 会直接报字体找不到。如果你需要指定具体字体比如学校要求正文用宋体、标题用黑体\usepackage[UTF8]{ctex} \setCJKmainfont{SimSun} \setCJKsansfont{SimHei} \setCJKmonofont{FangSong}字体名必须是系统里真实存在的名字。查字体名的办法是在系统的字体设置里找或者直接把字体文件拷到项目目录里用Path和Extension参数指定文件名这样换电脑也不会因为缺字体而编译失败。4.4 正向搜索和反向搜索用一次就离不开SyncTeX 是我认为最被低估的功能。配置好之后正向搜索在源码里把光标放到某一段按CtrlAltJPDF 会跳到对应位置。反向搜索在 PDF 预览里按住Ctrl点击某处源码会跳到对应行。写长论文时你经常需要“这段落排出来是什么样”“这一页的表格源码在哪”有这两个功能来回确认格式的时间能省掉一大半。如果你用的是外部 PDF 阅读器比如 SumatraPDF需要在 VS Code 设置里把查看器改成external并在 SumatraPDF 里配置反向搜索的命令行参数稍微麻烦一点但阅读体验更顺。5. LaTeX 语法写论文真正用得上的那一部分5.1 最小文档结构与导言区任何一个.tex文件骨架都是三段\documentclass[12pt, a4paper]{article} % 文档类 \usepackage{graphicx} % 导言区加载宏包 \usepackage{amsmath} \begin{document} % 正文区开始 正文内容写在这里。 \end{document}\documentclass里的选项决定全局参数12pt是正文字号a4paper是纸张。article适合短论文report适合有章节的长文档book是书学位论文一般直接用学校提供的自定义文档类比如\documentclass{xxxuniversitythesis}。导言区里\usepackage的顺序有时会有影响。经验规则是先加载基础宏包再加载自定义宏包。如果两个宏包都要重定义同一个命令后加载的会覆盖前面的报错信息通常是Command \xxx already defined这时用\usepackage{宏包名}换成带选项的版本或者用\let手动让位。5.2 换行、分段、间距这几个符号别再搞混搜“latex 换行符怎么打”的人特别多因为这里的坑确实多。我把这几个命令的区别整理成一张表写法效果使用场景空一行开始新段落段首自动缩进正文分段最常用\\强制换行不产生新段落诗歌、地址、表格单元格内\newline强制换行与\\基本相同语义更清楚时用\linebreak在当前位置断行并把整行拉伸到满宽极少用\par显式开始新段落等同于空一行宏定义内部常用\newpage强制换页章节之间手动画分页\noindent取消本段首行缩进摘要、特殊段落~不断行空格防止“图 1”被拆到两行最容易犯的两个错误一是拿\\当分段用结果段首缩进和段间距全不对而且后面如果接\section之类的命令会直接报错Theres no line here to end二是在\paragraph之类的短标题里塞\\同样会翻车。还有两个和中文相关的细节ctex已经帮你处理了中英文之间自动加空隙所以不要手动敲空格中文标点不用转义但英文环境下的%、、_、#、$这些符号必须转义成\%、\、\_、\#、\$。我曾经帮人看一个报错就是参考文献标题里有个50%%把后半行全注释掉了编译看起来成功但内容少了一半找了一小时。5.3 数学公式与符号速查这是 LaTeX 最不可替代的部分。行内公式用$...$独立成行的用equation环境行内公式 $E mc^2$ 夹在文字里。 \begin{equation} \label{eq:main} f(x) \int_{-\infty}^{\infty} \hat{f}(\xi)\, e^{2\pi i \xi x} \, d\xi \end{equation} 公式 \eqref{eq:main} 说明了……多行对齐用align环境标记对齐位置\\换行\begin{align} a b c \\ d e f \end{align}常用符号我列一张能覆盖九成写作场景的表需求写法显示效果上下标x^2,a_ix², aᵢ多字符上下标x^{10},a_{ij}x¹⁰, aⱼ分数\frac{a}{b}a/b 竖排根号\sqrt{x},\sqrt[3]{x}√x, ∛x求和\sum_{i1}^{n}Σ积分\int_0^1,\iint∫, ∬希腊字母\alpha\beta\Gammaα β Γ关系符\leq\geq\neq\approx≤ ≥ ≠ ≈集合\in\subset\cup\cap∈ ⊂ ∪ ∩箭头\to\Rightarrow\leftrightarrow→ ⇒ ↔花体\mathcal{L}向量\vec{v},\mathbf{v}v⃗,v极限\lim_{x \to 0}lim矩阵\begin{matrix} ... \end{matrix}矩阵几个容易踩的点求和、积分的上下限在行内模式下默认放在右侧而不是上下方想强制放在上下方用\limits公式里想插入正常文字用\text{其中}不要直接敲中文\label必须放在公式环境内部放在外面引用不到。5.4 插图位置乱跑是正常的别跟它较劲LaTeX 里插图用的是浮动体figure意思是“这张图排在这附近就行”。很多人第一次看到图片跑到下一页会抓狂其实这是设计行为。基本写法\begin{figure}[htbp] \centering \includegraphics[width0.8\textwidth]{figures/result.png} \caption{实验结果对比} \label{fig:result} \end{figure} 如图 \ref{fig:result} 所示……[htbp]是位置偏好here当前位置、top页顶、bottom页底、page单独一页。LaTeX 会按这个顺序尝试但最终由排版算法决定。实操里我总结了几条经验第一先别急着用[H]。强制固定位置需要float宏包用了之后确实不动了但代价是页面底部可能出现大片空白甚至图片被推到章节末尾。除非学校格式明确要求否则先接受默认浮动。第二图片尺寸用相对宽度。width0.8\textwidth表示正文宽度的 80%这样换纸张、换模板都不用改。用绝对长度比如width10cm在双栏模板里很容易溢出。第三\caption放在\includegraphics之后。这决定图注显示在图下方。如果放前面图注会跑到图上面。表格正好相反\caption要放在表格内容之前。第四图片文件不要用中文名。某些引擎处理中文文件名会报Cannot determine size of graphic改成fig1.png立刻好。第五一张图包含多个子图时用subcaption宏包能生成 (a)(b)(c) 子标签和统一的总标题比手动拼图省事得多。5.5 表格与自动换行这一块最容易翻车表格是 LaTeX 里最让人头疼的部分也是搜“latex 表格自动换行”的人最多的原因。基础写法\begin{table}[htbp] \centering \caption{参数配置} \label{tab:params} \begin{tabular}{lcc} \hline 参数 取值 说明 \\ \hline 学习率 0.001 初始值 \\ 批大小 32 受显存限制 \\ \hline \end{tabular} \end{table}{lcc}里的字母是每列的对齐方式l左对齐、c居中、r右对齐。列之间可以用|加竖线但学术排版一般不推荐竖线。核心问题来了普通tabular的单元格不会自动换行。内容长了会直接冲出页面。三种解决办法方案一用p{宽度}指定列宽超长内容自动折行\begin{tabular}{p{3cm}p{6cm}}方案二用tabularx宏包让某一列自动分配剩余宽度\usepackage{tabularx} \begin{tabularx}{\textwidth}{lX} 参数 一段很长的说明文字会自动换行并撑满剩余宽度 \\ \end{tabularx}X列是最省心的做法它会自动计算剩余空间并等分适合“一列短标签 一列长描述”的常见结构。方案三单元格内部手动断行用makecell宏包\usepackage{makecell} \makecell{第一行\\第二行}如果表格特别宽横向放不下可以用sidewaystable环境把它旋转 90 度或者干脆把表格拆成两张。另外提醒一句表格列数很多时先在纸上画出结构再敲代码比在编辑器里反复试要快得多这是我踩了无数次坑之后的习惯。5.6 参考文献一次配置终身受益手写参考文献是浪费时间的行为。正确做法是维护一个.bib文件每条文献一个条目article{zhang2023deep, author {Zhang, San and Li, Si}, title {A Deep Model for Something}, journal {Journal of Examples}, year {2023}, volume {12}, number {3}, pages {45--67} }正文里用\cite{zhang2023deep}引用编译时由bibtex去取数据并按样式文件格式化。样式由\bibliographystyle{...}指定常见的比如plain数字编号、ieeetrIEEE 风格、apalike作者年份制。这里有一个大坑必须提前说\bibliographystyle和biblatex不能混用。前者是老一代方案配合bibtex后者是新一代方案配合biber。你要是抄了别人的.bib文件又抄了另一套模板很容易出现“引用了但没进文献表”或者“文献表里有多余条目”。判断方法很简单看模板的.tex文件里是\usepackage{biblatex}还是\bibliographystyle然后照着它的方案走不要自己换。还有一个细节bibtex对大小写敏感度、特殊字符的处理比较死板。文献标题里的大写字母比如专有名词容易被自动转成小写这时候用花括号把它包起来{DNA}这样就能保留原样。6. 拿到论文模板之后该怎么做6.1 先做三件事别急着填内容很多人拿到模板第一件事就是把内容往里灌结果写到一半发现模板解压错了、编译不过、宏包冲突返工成本极高。我建议的顺序是第一先编译一份空模板。什么内容都不加直接编译。能出 PDF 说明环境和模板是匹配的。这一步如果失败问题一定在环境不在你写的代码。第二只改标题、作者、摘要三处再编译一次。这一步是验证你改动的位置对不对尤其是摘要、关键词这类容易被模板用特殊环境包裹的部分。第三写两页正文包含一个章节、一个公式、一张图、一张表、一条引用再编译。这一步是压力测试能提前暴露八成问题。6.2 模板目录结构怎么读一个标准的学位论文模板目录大致长这样thesis/ main.tex 主文件包含文档类声明和 \input chapters/ ch1-intro.tex 第一章 ch2-related.tex 第二章 figures/ 图片 refs.bib 文献数据库 setup/ 样式定义、封面、声明页 Makefile 或 build.sh 编译脚本主文件main.tex通常用\input{chapters/ch1-intro}把各章拼进来。注意\input后面不要加.tex后缀加了有些模板会报错。看模板时重点盯三个地方导言区加载了哪些宏包、文档类是什么、有没有自定义命令。自定义命令通常是学校要求的特殊格式比如\schoolname{}、\keywords{}照着示例填就行别自己造。6.3 提交前必须过一遍的检查清单论文最终提交我每次都按这张单子过检查项具体做法目录页码正确重新编译三遍确认目录里的页码和正文一致交叉引用无问号全文搜索??找到就是引用没编译进去图片清晰度别用截屏图片矢量图优先位图至少 300 dpi参考文献齐全对照正文引用列表逐条核对是否有遗漏或多出字体嵌入提交 PDF 前确认字体已嵌入否则对方打开可能乱码空白页检查有没有因浮动体被推挤产生的空白页文件清单期刊要求提交源码时确认.bbl、图片、宏包是否齐全最后一项特别容易被忽略。有些期刊的投稿系统要求上传源码压缩包你在本地编译能过是因为你电脑上装着完整宏包对方的系统可能只装了基础宏包这就需要你把自定义的.sty文件和图片一起打包必要时连字体文件也带上。7. 报错排查这些坑我都替你踩过7.1 高频报错速查表LaTeX 的报错信息出了名的不友好经常报错行号和真实位置差好几行。下面这张表是我这几年积累下来的高频问题报错信息真实原因解决办法File xxx.sty not found宏包没装tlmgr install 宏包名或换个镜像重装Undefined control sequence命令拼错或宏包没加载检查拼写确认对应宏包在导言区Missing $ inserted数学符号写在了文本模式用$...$包起来或给_^加转义Runaway argument?括号没配对常见于{}少一个从报错行往上找未闭合的括号Theres no line here to end在段落开头或标题里用了\\删掉或改用空一行分段Too many }s多了一个右括号常见于\end{}和\begin{}环境名不匹配Citation xxx undefined文献没编译进去跑 bibtex 再编译两遍Reference xxx undefined交叉引用没编译进去再多编译一遍Overfull \hbox某行太宽内容溢出是警告不是错误检查长公式或长单词中文变成方框字体没配好用 xelatex 编译检查ctex和字体设置7.2 读日志文件的正确姿势报错刷了一屏怎么找关键我的做法是先看第一个!开头的行后面第一个l.数字就是报错位置。很多人从下往上找找到的是连锁反应产生的后续错误真实原因在最上面。然后打开.log文件搜索!从第一个开始看。日志里Overfull \hbox和Underfull \hbox是警告不影响生成 PDF初学阶段可以先忽略。如果日志信息看不懂用-file-line-error参数前面配置里已经加了报错会变成文件名:行号: 错误信息的格式定位速度快很多。还有一个实用技巧二分法定位。把文档后半部分整体注释掉编译能过说明问题在后半部分再把后半部分二分两三轮就能锁定到具体段落。这个方法听起来笨但比盯着报错信息猜要靠谱得多。7.3 几个反直觉的经验第一个经验宏包加载顺序会引发玄学问题。我遇到过一次hyperref加载在cleveref之后结果所有交叉引用都失效两个宏包单独用都正常换顺序就对了。所以遇到“查不出原因”的问题先试试调整宏包加载顺序。第二个经验编译缓存也会出问题。有时候代码明明改对了PDF 还是旧的样子这时候删掉所有中间文件重新编译VS Code 里有个Clean up auxiliary files的命令或者手动删.aux.bbl.toc往往立刻正常。第三个经验别在毕业论文里边写边更新宏包。写一半的时候手痒跑了tlmgr update --all结果某个宏包更新后和模板不兼容前功尽弃。要更新等提交完再更新。第四个经验Git 提交时加.gitignore。把.aux.log.toc.out.bbl这些中间产物排除掉仓库会干净很多也不会有无意义的合并冲突。但如前所述正式提交给期刊的源码包不在这个规则里。最后再分享一个小技巧如果你需要大量重复的表格结构与其一行行敲不如写一个简单的 Python 脚本读取 CSV 生成 LaTeX 代码。我用这个办法把一个四十行的数据表从半小时的手工活压缩到十秒而且在数据更新时直接重新生成就行不会因为手改漏掉单元格。这个脚本二十行代码就够值得花十分钟写一次。我在带人写论文的过程中最深的体会是LaTeX 真正卡住新手的从来不是语法而是环境。语法部分翻半小时文档就能上手环境问题却能耗掉一整个晚上。所以按上面这套流程先把引擎、编辑器、编译链三样东西固定下来之后再遇到任何问题你至少能确定“环境是好的问题在我写的代码里”排查范围一下就缩小了一半。 
长河君 · 2026/10/1 2:22:14 · 阅读 1.2k LaTeX 论文排版实战：Windows 下 TeX Live 安装与报错排查
排版这件事平时不痛不痒真到了要交三十页毕业论文、或者投一份格式要求苛刻的期刊稿件时才会发现 Word 那套“所见即所得”的思路有多让人抓狂插图一挪位置就跑公式编号手动改到怀疑人生参考文献格式换一本期刊就得重排一遍目录页码刷半天刷不出来。LaTeX 就是冲着这些场景来的它本质是一套论文排版工具你用纯文本写内容、打标记剩下的字体、行距、编号、交叉引用、参考文献格式交给一套排版引擎自动算。它不神秘也不是学术圈的门槛只是一个把“排版”和“写作”彻底拆开的工具。这篇东西我按自己带师弟师妹的流程来写先讲清楚 LaTeX 到底在干什么、编译链是怎么跑起来的再给出一套 Windows 下从头到尾的安装教程然后是编辑器配置、语法最小可用集、论文模板怎么改最后是我这几年攒下来的报错速查表。安装教程部分我以 TeX Live 完整版为主线它是目前兼容性最稳、坑最少的一条路使用教程部分不会把宏包文档抄一遍只讲你写论文真正会用到的那二三十个命令。完全没碰过命令行的本科生能照着走完用过一阵子的人也能在里面翻到几条能省时间的配置。1. 先搞懂 LaTeX 到底在做什么1.1 内容和排版分离这才是核心Word 的思路是“你看到什么就是什么”你敲字的时候顺手调格式格式和内容搅在一起。写三页的文档没问题写三千页的文档就完蛋。LaTeX 的思路反过来你只负责写内容并打上语义标记比如“这里是二级标题”“这里是一张图片”“这里要引用文献 3”具体二级标题该用多大字号、图片该浮到哪里、文献 3 该显示成 [3] 还是 (Zhang et al., 2023)全由样式文件决定。这个差别带来的最大好处不是“好看”而是一致性可以被机器保证。你论文里有一百三十处交叉引用改动了章节顺序之后编号会自动重算你有一百二十条参考文献换一个期刊模板全文引用格式一次性重排你一个字母都不用动。我在实际使用中发现真正让人回不去 Word 的就是这一点。还有一个隐性优势.tex文件是纯文本。这意味着你可以用 Git 做版本管理可以 diff 出“这次改了什么”可以多人协作时靠合并工具解决冲突。相比之下.docx是压缩包里的二进制 XML冲突了基本只能靠人力肉眼比对。1.2 一次编译到底发生了多少次“搬运”很多人第一次用 LaTeX 会困惑为什么目录是空的为什么引用显示成??为什么非要编译两遍答案在编译链里。一次完整的编译通常涉及四个程序接力程序作用产物xelatex或pdflatex读取.tex生成排版结果.pdf、.auxbibtex或biber读取.aux里的引用需求去.bib数据库取数据.bblxelatex第二遍读.bbl把参考文献排进去更新的.auxxelatex第三遍读取上一遍写入的页码、编号填进目录和引用最终.pdf.aux这个中间文件是关键它相当于排版引擎留给自己的便签本目录里每个章节在第几页、每个\label对应什么编号全都写在这。所以目录空、引用问号、公式编号乱九成情况是编译次数不够不是代码写错了。理解了这一层后面排查问题会轻松很多。顺带说一句latexmk。它是个自动化脚本会根据.aux的依赖关系自动判断该跑几遍、要不要跑 bibtex。用上它之后你只需要按一次编译键这也是下面编辑器配置里我强烈推荐用它做默认工具的原因。1.3 什么情况该上 LaTeX什么情况别硬上不是所有文档都值得用 LaTeX。我个人的判断标准是三条数学公式密度高一篇文档里超过二十个公式或者需要多行对齐、矩阵、分段函数LaTeX 的收益立刻拉开差距。格式要求由外部规定期刊、学位论文有模板你不想跟格式要求较劲那就用模板。文档规模大且结构复杂章节多、图表多、交叉引用多、参考文献多涉及反复修改。反过来如果是给同事发的一份周报、一份产品需求文档、一张带排版的简历用 LaTeX 就是自找麻烦Word 或者在线文档二十分钟搞定的事没必要配置环境。我见过有人为了做一份两页的社团通知折腾一下午 TeX 环境这个性价比实在不高。2. 安装方案选型三条主流路线怎么挑2.1 三个发行版的能力对比所谓“安装 LaTeX”准确说法是安装一个 TeX 发行版。发行版 排版引擎 几万个宏包 字体 辅助工具打包在一起。主流选择有三个发行版平台安装体积更新策略适合谁TeX LiveWindows / Linux / macOS完整版约 7–8 GB年度版本可在线更新宏包首选兼容性最好模板作者一般都拿它测MiKTeXWindows / macOS / Linux初始约 200 MB用到哪个宏包下载哪个硬盘紧张、或者只做轻量文档MacTeXmacOS约 6 GB本质是 TeX Live 的 Mac 封装Mac 用户装了就等于装了 TeX Live我给你一个不太“官方”但很实在的建议只要是正儿八经写论文直接 TeX Live 完整版。MiKTeX 的按需下载听起来很香但它的代价是编译过程中可能突然弹窗或卡住去下宏包网络不好的时候编译速度会被拖得很难受更麻烦的是很多学位论文模板依赖一些冷门宏包第一次编译满载下载报错信息还容易被下载日志淹没。2.2 关于“latex 下载”这件事先把来源搞清楚搜索引擎里搜“latex 下载”排在前面的往往是一些第三方站的“绿色版”“精简版”“免安装便携版”。我的建议很明确只从发行版官方渠道下载。原因有三个第一TeX 系统里有大量可执行文件从不明来源拿来的安装包你没法确认里面有没有被塞进别的东西。第二精简版通常砍掉了字体和文档你后面遇到File xxx.sty not found之类的报错原因就是被砍掉了你还要花时间补回来。第三这些版本更新频率低宏包版本老遇到新模板直接编译不过。下载的时候注意一件事用镜像站。官方主站的下载速度在某些时段会非常慢国内几个高校和镜像站点都有完整同步用镜像下载能把几个小时压到十几分钟。安装器里也内置了镜像选择安装中途可以切换。2.3 先把磁盘和时间的预算算清楚在动手之前先把这两个数字看清楚免得装到一半发现空间不够磁盘完整安装约 7–8 GB加上后续更新和临时文件建议预留 15 GB 以上。装在机械硬盘上编译大文档会明显慢有条件放固态。时间网络顺畅的情况下完整安装 20–40 分钟网络一般的话一两个小时也正常。这个过程可以干别的事但别关电脑。还有一个容易被忽略的点安装路径不要带中文和空格。像D:\我的论文\texlive或者D:\Program Files\texlive这种某些宏包在处理文件路径时会出问题报错信息还很难懂。用D:\texlive\2024这种干净路径能避开一大类莫名其妙的故障。3. Windows 下 TeX Live 安装完整实操3.1 下载安装器与镜像选择打开 TeX Live 官方页面下载install-tl-windows.exe。这个 exe 其实是个引导器运行后会先连网下载真正的安装程序。双击之后会出现两个选项Simple / 简易安装一键装完整版几乎不需要做选择。Advanced / 高级安装可以自定义组件、路径、镜像。我一般选高级安装理由有三个能改安装路径默认路径难记、能选镜像决定下载速度、能关掉一些用不上的语言包省空间。安装器界面左侧有一个Directories区块把TEXDIR改成你准备好的干净路径比如D:\texlive\2024。镜像选择在安装器界面上部有个下拉框一般会自动测速。如果自动选中的那个下载速度很慢进度条半小时不动手动换一个。判断标准很简单看剩余时间估计如果超过三个小时就换。3.2 安装选项逐项拆解进入高级安装之后会看到一堆组件勾选框容易让人懵。按我的习惯这样处理Scheme安装方案选full也就是完整安装。不要选basic或者medium理由前面说过。Language collectionsChinese、Chinese/Japanese/Korean这两个可以留着中间有中文排版要用的东西。TeXworks editor可以留着装完先拿它验证环境能不能跑通后面换 VS Code。Install TeX Live documentation这个会多占一两个 GB如果你习惯本地查文档就留着主要靠在线查的话可以取消。Create symlinks之类的选项在 Windows 上一般不需要动。参数确认之后点安装剩下的就是等。安装过程中有一个细节值得注意关闭杀毒软件的实时扫描或者把安装目录加进白名单。TeX Live 会在短时间内释放几十万个小文件实时扫描会把这个过程拖得非常慢我遇到过装了两小时才装完一半的情况加白名单之后 25 分钟结束。注意安装过程中不要中途强退。TeX Live 的安装不是原子操作中断之后目录可能处于半成品状态重新安装时容易因为残留文件报错。真需要中断先把整个安装目录删干净再重来。3.3 装完必须做的三项验证安装器跑完最后一步会打印一行提示告诉你哪些环境变量已经设置好。很多人到这里就直接开编辑器了结果一堆“命令找不到”的报错。我建议先做三项验证命令行里敲xelatex --version bibtex --version latexmk --version三行都能打印出版本号说明 PATH 配好了。如果提示“不是内部或外部命令”有两个可能一是安装时没勾选创建环境变量二是你当前开着命令行窗口而 PATH 是在窗口打开之后才修改的需要关掉重开。老版本的 Windows 需要重新登录一次才能生效。第二项验证写一个最小文档编译一次。新建test.tex\documentclass{article} \begin{document} Hello, \LaTeX. \end{document}在命令行里cd到文件所在目录执行xelatex test.tex同目录下应该出现test.pdf。这一步跑通说明引擎可用。第三项验证tlmgr能连上镜像。执行tlmgr update --self如果能正常列出更新信息说明后续可以自己维护宏包。这一步很多人跳过等到半年后模板需要新宏包时才发现更新不了还得重新排查。4. 编辑器怎么选怎么配4.1 编辑器对比别在选型上纠结太久TeX Live 自带的 TeXworks 能用但功能比较基础。真正写论文我建议从下面几个里挑编辑器优势短板推荐度VS Code LaTeX Workshop生态好、配置可控、能和其他语言共用需要手写一段 JSON 配置最推荐TeXstudio开箱即用菜单里能改的东西多界面偏老大项目偶尔卡新手友好TeXworks装了就有零配置功能单薄没有正向反向搜索应急在线平台不装环境多人协作方便依赖网络大文件编译慢临时救急Vim / Emacs键盘流效率天花板学习曲线陡老手自便如果你已经装了 VS Code 并且常用那就别折腾了直接配 LaTeX Workshop一劳永逸。如果完全没接触过 VS CodeTeXstudio 的菜单式配置更省心。4.2 VS Code LaTeX Workshop 配置逐行说明先装两个东西VS Code 本体以及扩展市场里的LaTeX Workshop。装完之后打开设置切到 JSON 模式快捷键CtrlShiftP输入Open Settings (JSON)把下面这段贴进去{ latex-workshop.latex.recipes: [ { name: xelatex - bibtex - xelatex*2, tools: [xelatex, bibtex, xelatex, xelatex] }, { name: latexmk (xelatex), tools: [latexmk-xe] } ], latex-workshop.latex.tools: [ { name: xelatex, command: xelatex, args: [ -synctex1, -interactionnonstopmode, -file-line-error, %DOC% ] }, { name: bibtex, command: bibtex, args: [%DOCFILE%] }, { name: latexmk-xe, command: latexmk, args: [ -xelatex, -synctex1, -interactionnonstopmode, -file-line-error, %DOC% ] } ], latex-workshop.latex.autoClean.run: onBuilt, latex-workshop.latex.clean.fileTypes: [ *.aux, *.bbl, *.blg, *.idx, *.ind, *.lof, *.lot, *.out, *.toc, *.acn, *.acr, *.alg, *.glg, *.glo, *.gls, *.fls, *.log, *.fdb_latexmk, *.snm, *.nav ], latex-workshop.view.pdf.viewer: tab, latex-workshop.latex.autoBuild.run: onFileChange }逐项解释一下为什么这么写不然你以后改了配置出问题不知道怎么回退recipes是编译方案的组合。第一个方案面向中文论文走xelatex编译、bibtex处理文献、再补两遍xelatex填目录和引用。第二个方案用latexmk一次性搞定适合追求速度的日常编译。tools里每一项对应一条可执行命令。-synctex1是关键参数它让 PDF 和源码之间建立坐标映射你才能在 PDF 上点一下跳回源码、在源码里跳回 PDF 对应位置。-interactionnonstopmode保证遇到错误不弹交互提示否则无人值守编译会永久卡住。-file-line-error让报错信息带上文件名和行号排查效率翻倍。autoClean.run: onBuilt表示每次编译成功后自动清理中间文件。这个设置很有必要否则一个论文目录里会堆几十个.aux、.bbl、.log用 Git 提交的时候一片红。但要注意如果你要提交给期刊的源码包临时关掉这个设置因为有些期刊要求你连.bbl一起提交。这是个真事我帮人改模板时见过有人把所有中间文件清干净了结果对方编辑说缺少编译产物。view.pdf.viewer: tab让 PDF 在 VS Code 里的标签页中预览边写边看不用切窗口。4.3 中文排版为什么必须用 xelatex这是个高频困惑点为什么别人给的命令是pdflatex我配的却是xelatex简单类比pdflatex是个老式打字机它只认早期的字体格式处理中文需要走一堆转换流程xelatex是新一代引擎可以直接调用系统里装好的字体文件。你写中文论文只要在导言区加一句\usepackage{ctex}ctex宏包会自动帮你配置好中文字体、中文标点、章节标题的“第几章”字样、以及中英文间距。注意一个细节用ctex宏包时编译必须走 xelatex用 pdflatex 会直接报字体找不到。如果你需要指定具体字体比如学校要求正文用宋体、标题用黑体\usepackage[UTF8]{ctex} \setCJKmainfont{SimSun} \setCJKsansfont{SimHei} \setCJKmonofont{FangSong}字体名必须是系统里真实存在的名字。查字体名的办法是在系统的字体设置里找或者直接把字体文件拷到项目目录里用Path和Extension参数指定文件名这样换电脑也不会因为缺字体而编译失败。4.4 正向搜索和反向搜索用一次就离不开SyncTeX 是我认为最被低估的功能。配置好之后正向搜索在源码里把光标放到某一段按CtrlAltJPDF 会跳到对应位置。反向搜索在 PDF 预览里按住Ctrl点击某处源码会跳到对应行。写长论文时你经常需要“这段落排出来是什么样”“这一页的表格源码在哪”有这两个功能来回确认格式的时间能省掉一大半。如果你用的是外部 PDF 阅读器比如 SumatraPDF需要在 VS Code 设置里把查看器改成external并在 SumatraPDF 里配置反向搜索的命令行参数稍微麻烦一点但阅读体验更顺。5. LaTeX 语法写论文真正用得上的那一部分5.1 最小文档结构与导言区任何一个.tex文件骨架都是三段\documentclass[12pt, a4paper]{article} % 文档类 \usepackage{graphicx} % 导言区加载宏包 \usepackage{amsmath} \begin{document} % 正文区开始 正文内容写在这里。 \end{document}\documentclass里的选项决定全局参数12pt是正文字号a4paper是纸张。article适合短论文report适合有章节的长文档book是书学位论文一般直接用学校提供的自定义文档类比如\documentclass{xxxuniversitythesis}。导言区里\usepackage的顺序有时会有影响。经验规则是先加载基础宏包再加载自定义宏包。如果两个宏包都要重定义同一个命令后加载的会覆盖前面的报错信息通常是Command \xxx already defined这时用\usepackage{宏包名}换成带选项的版本或者用\let手动让位。5.2 换行、分段、间距这几个符号别再搞混搜“latex 换行符怎么打”的人特别多因为这里的坑确实多。我把这几个命令的区别整理成一张表写法效果使用场景空一行开始新段落段首自动缩进正文分段最常用\\强制换行不产生新段落诗歌、地址、表格单元格内\newline强制换行与\\基本相同语义更清楚时用\linebreak在当前位置断行并把整行拉伸到满宽极少用\par显式开始新段落等同于空一行宏定义内部常用\newpage强制换页章节之间手动画分页\noindent取消本段首行缩进摘要、特殊段落~不断行空格防止“图 1”被拆到两行最容易犯的两个错误一是拿\\当分段用结果段首缩进和段间距全不对而且后面如果接\section之类的命令会直接报错Theres no line here to end二是在\paragraph之类的短标题里塞\\同样会翻车。还有两个和中文相关的细节ctex已经帮你处理了中英文之间自动加空隙所以不要手动敲空格中文标点不用转义但英文环境下的%、、_、#、$这些符号必须转义成\%、\、\_、\#、\$。我曾经帮人看一个报错就是参考文献标题里有个50%%把后半行全注释掉了编译看起来成功但内容少了一半找了一小时。5.3 数学公式与符号速查这是 LaTeX 最不可替代的部分。行内公式用$...$独立成行的用equation环境行内公式 $E mc^2$ 夹在文字里。 \begin{equation} \label{eq:main} f(x) \int_{-\infty}^{\infty} \hat{f}(\xi)\, e^{2\pi i \xi x} \, d\xi \end{equation} 公式 \eqref{eq:main} 说明了……多行对齐用align环境标记对齐位置\\换行\begin{align} a b c \\ d e f \end{align}常用符号我列一张能覆盖九成写作场景的表需求写法显示效果上下标x^2,a_ix², aᵢ多字符上下标x^{10},a_{ij}x¹⁰, aⱼ分数\frac{a}{b}a/b 竖排根号\sqrt{x},\sqrt[3]{x}√x, ∛x求和\sum_{i1}^{n}Σ积分\int_0^1,\iint∫, ∬希腊字母\alpha\beta\Gammaα β Γ关系符\leq\geq\neq\approx≤ ≥ ≠ ≈集合\in\subset\cup\cap∈ ⊂ ∪ ∩箭头\to\Rightarrow\leftrightarrow→ ⇒ ↔花体\mathcal{L}向量\vec{v},\mathbf{v}v⃗,v极限\lim_{x \to 0}lim矩阵\begin{matrix} ... \end{matrix}矩阵几个容易踩的点求和、积分的上下限在行内模式下默认放在右侧而不是上下方想强制放在上下方用\limits公式里想插入正常文字用\text{其中}不要直接敲中文\label必须放在公式环境内部放在外面引用不到。5.4 插图位置乱跑是正常的别跟它较劲LaTeX 里插图用的是浮动体figure意思是“这张图排在这附近就行”。很多人第一次看到图片跑到下一页会抓狂其实这是设计行为。基本写法\begin{figure}[htbp] \centering \includegraphics[width0.8\textwidth]{figures/result.png} \caption{实验结果对比} \label{fig:result} \end{figure} 如图 \ref{fig:result} 所示……[htbp]是位置偏好here当前位置、top页顶、bottom页底、page单独一页。LaTeX 会按这个顺序尝试但最终由排版算法决定。实操里我总结了几条经验第一先别急着用[H]。强制固定位置需要float宏包用了之后确实不动了但代价是页面底部可能出现大片空白甚至图片被推到章节末尾。除非学校格式明确要求否则先接受默认浮动。第二图片尺寸用相对宽度。width0.8\textwidth表示正文宽度的 80%这样换纸张、换模板都不用改。用绝对长度比如width10cm在双栏模板里很容易溢出。第三\caption放在\includegraphics之后。这决定图注显示在图下方。如果放前面图注会跑到图上面。表格正好相反\caption要放在表格内容之前。第四图片文件不要用中文名。某些引擎处理中文文件名会报Cannot determine size of graphic改成fig1.png立刻好。第五一张图包含多个子图时用subcaption宏包能生成 (a)(b)(c) 子标签和统一的总标题比手动拼图省事得多。5.5 表格与自动换行这一块最容易翻车表格是 LaTeX 里最让人头疼的部分也是搜“latex 表格自动换行”的人最多的原因。基础写法\begin{table}[htbp] \centering \caption{参数配置} \label{tab:params} \begin{tabular}{lcc} \hline 参数 取值 说明 \\ \hline 学习率 0.001 初始值 \\ 批大小 32 受显存限制 \\ \hline \end{tabular} \end{table}{lcc}里的字母是每列的对齐方式l左对齐、c居中、r右对齐。列之间可以用|加竖线但学术排版一般不推荐竖线。核心问题来了普通tabular的单元格不会自动换行。内容长了会直接冲出页面。三种解决办法方案一用p{宽度}指定列宽超长内容自动折行\begin{tabular}{p{3cm}p{6cm}}方案二用tabularx宏包让某一列自动分配剩余宽度\usepackage{tabularx} \begin{tabularx}{\textwidth}{lX} 参数 一段很长的说明文字会自动换行并撑满剩余宽度 \\ \end{tabularx}X列是最省心的做法它会自动计算剩余空间并等分适合“一列短标签 一列长描述”的常见结构。方案三单元格内部手动断行用makecell宏包\usepackage{makecell} \makecell{第一行\\第二行}如果表格特别宽横向放不下可以用sidewaystable环境把它旋转 90 度或者干脆把表格拆成两张。另外提醒一句表格列数很多时先在纸上画出结构再敲代码比在编辑器里反复试要快得多这是我踩了无数次坑之后的习惯。5.6 参考文献一次配置终身受益手写参考文献是浪费时间的行为。正确做法是维护一个.bib文件每条文献一个条目article{zhang2023deep, author {Zhang, San and Li, Si}, title {A Deep Model for Something}, journal {Journal of Examples}, year {2023}, volume {12}, number {3}, pages {45--67} }正文里用\cite{zhang2023deep}引用编译时由bibtex去取数据并按样式文件格式化。样式由\bibliographystyle{...}指定常见的比如plain数字编号、ieeetrIEEE 风格、apalike作者年份制。这里有一个大坑必须提前说\bibliographystyle和biblatex不能混用。前者是老一代方案配合bibtex后者是新一代方案配合biber。你要是抄了别人的.bib文件又抄了另一套模板很容易出现“引用了但没进文献表”或者“文献表里有多余条目”。判断方法很简单看模板的.tex文件里是\usepackage{biblatex}还是\bibliographystyle然后照着它的方案走不要自己换。还有一个细节bibtex对大小写敏感度、特殊字符的处理比较死板。文献标题里的大写字母比如专有名词容易被自动转成小写这时候用花括号把它包起来{DNA}这样就能保留原样。6. 拿到论文模板之后该怎么做6.1 先做三件事别急着填内容很多人拿到模板第一件事就是把内容往里灌结果写到一半发现模板解压错了、编译不过、宏包冲突返工成本极高。我建议的顺序是第一先编译一份空模板。什么内容都不加直接编译。能出 PDF 说明环境和模板是匹配的。这一步如果失败问题一定在环境不在你写的代码。第二只改标题、作者、摘要三处再编译一次。这一步是验证你改动的位置对不对尤其是摘要、关键词这类容易被模板用特殊环境包裹的部分。第三写两页正文包含一个章节、一个公式、一张图、一张表、一条引用再编译。这一步是压力测试能提前暴露八成问题。6.2 模板目录结构怎么读一个标准的学位论文模板目录大致长这样thesis/ main.tex 主文件包含文档类声明和 \input chapters/ ch1-intro.tex 第一章 ch2-related.tex 第二章 figures/ 图片 refs.bib 文献数据库 setup/ 样式定义、封面、声明页 Makefile 或 build.sh 编译脚本主文件main.tex通常用\input{chapters/ch1-intro}把各章拼进来。注意\input后面不要加.tex后缀加了有些模板会报错。看模板时重点盯三个地方导言区加载了哪些宏包、文档类是什么、有没有自定义命令。自定义命令通常是学校要求的特殊格式比如\schoolname{}、\keywords{}照着示例填就行别自己造。6.3 提交前必须过一遍的检查清单论文最终提交我每次都按这张单子过检查项具体做法目录页码正确重新编译三遍确认目录里的页码和正文一致交叉引用无问号全文搜索??找到就是引用没编译进去图片清晰度别用截屏图片矢量图优先位图至少 300 dpi参考文献齐全对照正文引用列表逐条核对是否有遗漏或多出字体嵌入提交 PDF 前确认字体已嵌入否则对方打开可能乱码空白页检查有没有因浮动体被推挤产生的空白页文件清单期刊要求提交源码时确认.bbl、图片、宏包是否齐全最后一项特别容易被忽略。有些期刊的投稿系统要求上传源码压缩包你在本地编译能过是因为你电脑上装着完整宏包对方的系统可能只装了基础宏包这就需要你把自定义的.sty文件和图片一起打包必要时连字体文件也带上。7. 报错排查这些坑我都替你踩过7.1 高频报错速查表LaTeX 的报错信息出了名的不友好经常报错行号和真实位置差好几行。下面这张表是我这几年积累下来的高频问题报错信息真实原因解决办法File xxx.sty not found宏包没装tlmgr install 宏包名或换个镜像重装Undefined control sequence命令拼错或宏包没加载检查拼写确认对应宏包在导言区Missing $ inserted数学符号写在了文本模式用$...$包起来或给_^加转义Runaway argument?括号没配对常见于{}少一个从报错行往上找未闭合的括号Theres no line here to end在段落开头或标题里用了\\删掉或改用空一行分段Too many }s多了一个右括号常见于\end{}和\begin{}环境名不匹配Citation xxx undefined文献没编译进去跑 bibtex 再编译两遍Reference xxx undefined交叉引用没编译进去再多编译一遍Overfull \hbox某行太宽内容溢出是警告不是错误检查长公式或长单词中文变成方框字体没配好用 xelatex 编译检查ctex和字体设置7.2 读日志文件的正确姿势报错刷了一屏怎么找关键我的做法是先看第一个!开头的行后面第一个l.数字就是报错位置。很多人从下往上找找到的是连锁反应产生的后续错误真实原因在最上面。然后打开.log文件搜索!从第一个开始看。日志里Overfull \hbox和Underfull \hbox是警告不影响生成 PDF初学阶段可以先忽略。如果日志信息看不懂用-file-line-error参数前面配置里已经加了报错会变成文件名:行号: 错误信息的格式定位速度快很多。还有一个实用技巧二分法定位。把文档后半部分整体注释掉编译能过说明问题在后半部分再把后半部分二分两三轮就能锁定到具体段落。这个方法听起来笨但比盯着报错信息猜要靠谱得多。7.3 几个反直觉的经验第一个经验宏包加载顺序会引发玄学问题。我遇到过一次hyperref加载在cleveref之后结果所有交叉引用都失效两个宏包单独用都正常换顺序就对了。所以遇到“查不出原因”的问题先试试调整宏包加载顺序。第二个经验编译缓存也会出问题。有时候代码明明改对了PDF 还是旧的样子这时候删掉所有中间文件重新编译VS Code 里有个Clean up auxiliary files的命令或者手动删.aux.bbl.toc往往立刻正常。第三个经验别在毕业论文里边写边更新宏包。写一半的时候手痒跑了tlmgr update --all结果某个宏包更新后和模板不兼容前功尽弃。要更新等提交完再更新。第四个经验Git 提交时加.gitignore。把.aux.log.toc.out.bbl这些中间产物排除掉仓库会干净很多也不会有无意义的合并冲突。但如前所述正式提交给期刊的源码包不在这个规则里。最后再分享一个小技巧如果你需要大量重复的表格结构与其一行行敲不如写一个简单的 Python 脚本读取 CSV 生成 LaTeX 代码。我用这个办法把一个四十行的数据表从半小时的手工活压缩到十秒而且在数据更新时直接重新生成就行不会因为手改漏掉单元格。这个脚本二十行代码就够值得花十分钟写一次。我在带人写论文的过程中最深的体会是LaTeX 真正卡住新手的从来不是语法而是环境。语法部分翻半小时文档就能上手环境问题却能耗掉一整个晚上。所以按上面这套流程先把引擎、编辑器、编译链三样东西固定下来之后再遇到任何问题你至少能确定“环境是好的问题在我写的代码里”排查范围一下就缩小了一半。