简介西北工业大学LaTeX论文模板依据学校官方格式整合面向硕士、博士研究生适用于学位论文、毕业设计等正式文档排版。模板内置公式快速排版、目录自动生成、图片浮动对齐等能力有效解决Word在公式和目录方面的反复调整问题同时支持学位类型切换并提供封面、声明、摘要、致谢、附录等模块满足盲审与定稿两种需求。针对本地编译较慢的情况可与Overleaf结合按章节在线编辑再回归离线LaTeX环境兼顾流畅性与最终PDF输出质量。压缩包共五十个文件大小约4.14MB核心内容包含样式宏包、示例论文、编译预览、字体库、参考文献格式、使用说明与示意图等并附带构建脚本便于按需修改。已有二百四十八人学习/下载适合希望摆脱Word排版限制、提升论文规范性的硕博研究生参考使用。1. 毕业设计排版救星一份能直接编译的 LATEX 论文模板每年毕业季总有人因为 Word 里一级标题变成黑体、页眉多了一条线、目录页码对不上熬到凌晨三点。用 LATEX 写毕业论文本质上是用「编译期的一次性痛苦」换「排版期的一劳永逸」但很多人卡在第一步模板不会选。某高校这份 LATEX 论文模板不是那种丢给你一堆 .sty 文件就完事的半成品而是能直接编译出符合学校格式要求的完整论文骨架覆盖封面、摘要、目录、正文、参考文献到附录全部环节。适合两类人一是受够 Word 排版玄学的本科生二是被导师要求「格式必须严格按学校规范来」的毕业设计作者。接下来我从 struct 到坑逐个讲清楚。2. 模板骨架拆解目录结构与主文件的参数逻辑2.1 从压缩包到编译成功目录结构与编译入口拿到模板压缩包后第一件事是看目录结构而不是急着编译。我拆过不少论文模板这份的目录设计比较清晰典型的 LATEX 项目布局. ├── main.tex % 主文件编译入口 ├── thesis.cls % 文档类格式核心 ├── bib/ │ ├── ref.bib % BibTeX 参考文献数据库 │ └── gbt7714-2015.bst % 国标参考文献样式 ├── figures/ % 插图目录支持 eps/pdf/png/jpg ├── chapters/ │ ├── abstract.tex % 中英文摘要 │ ├── chapter1.tex % 绪论 │ ├── chapter2.tex % 后续章节 │ └── appendix.tex % 附录 └── Makefile % 可选自动化编译脚本主文件 main.tex 的结构决定了整个编译流程。我建议直接改 main.tex不要动 thesis.cls因为文档类文件里封装了大量格式规则改错一个参数就可能让所有章节标题错位。\documentclass[12pt, oneside, openany]{thesis} % 12pt: 正文字号oneside: 单面打印openany: 章可从任意页开始 \usepackage[UTF8]{ctex} \graphicspath{{figures/}} \begin{document} \include{chapters/abstract} % 摘要部分 \include{chapters/chapter1} % 正文第一章 \include{chapters/chapter2} % 正文第二章 \include{chapters/appendix} % 附录 \end{document}这里\include和\input有本质区别\include强制分页适合一章一个文件\input不换页适合摘要、致谢这类短内容。毕业设计模板一般混用两者主文件里看到\include就知道是章节边界。\graphicspath命令把图片根目录指向 figures 文件夹这样正文里写\includegraphics{fig1}就能直接找到图不用每次写相对路径。12pt 对应 Word 里的「小四」是本科毕业设计最常见的正文字号如果学校要求「四号」改成 14pt 即可。2.2 二八法则学位类型与双盲审的开关藏在这里模板里最容易被忽略的是文档类\documentclass的那些可选参数。我见过有人把盲审版封面直接删掉结果提交盲审时被判定格式不符因为盲审版需要隐藏作者和导师信息而删掉封面会让页眉页码全部移位。\documentclass[12pt, oneside, openany, blind]{thesis} % blind 参数触发盲审模式自动隐藏作者/导师信息模板里一般会预留blind和final两个模式默认是final。答辩前提交盲审版本时把参数换成blind编译后封面和页眉里的作者、导师信息就会自动变成占位符——这是最省事的做法比手动删内容再调页码可靠得多。学位类型通常在 main.tex 里用自定义命令控制\degree{本科毕业设计} % 可选硕士学位论文 / 博士学位论文 / 本科毕业设计 \title{基于深度学习的某图像处理系统设计与实现} \author{某同学} \studentid{202000012345} \supervisor{某教授} \major{计算机科学与技术}这些信息会在封面、摘要页眉、声明页中被引用。改 title 和 author 时要检查是否有特殊字符比如英文标题里的_或在 LATEX 里直接写会编译报错需要转义为\_和\。我在帮人调试时遇到过一次中文标题里的破折号「——」在某些字体下编译出乱码最后改成两个--才正常。3. 编译环境配置TeXstudio 与 VSCode 的选型与实操3.1 Windows 下 TeXstudio最快跑通的编译链配置LATEX 模板落地最痛的不是语法而是编译环境。很多第一次用 LATEX 的人装了 TeX Live 后不知道需要经过「XeLaTeX → BibTeX → XeLaTeX → XeLaTeX」四遍编译直接在编辑器里点一次编译就报「Citation undefined」。下面按照最常见的 Windows 环境给出 TeXstudio 的可抄配置。# 假设已安装 TeX Live 2024检查 xelatex 是否在 PATH 中 xelatex -version # 若提示找不到命令需手动添加环境变量 # 典型安装路径C:\texlive\2024\bin\windows # 添加到 PATH 后重新打开终端打开 TeXstudio 后「选项 → 设置 TeXstudio → 构建」里要确认三件事默认编译器选 XeLaTeX默认文献工具选 BibTeX默认编码选 UTF-8。然后配置完成后的首次完整编译顺序在终端里手动执行一次最稳xelatex -synctex1 -interactionnonstopmode main.tex # -synctex1 生成反向同步文件Ctrl点击可从 PDF 跳回源码 bibtex main # 处理参考文献数据库生成 .bbl xelatex -synctex1 -interactionnonstopmode main.tex # 第二次编译写入参考文献交叉引用 xelatex -synctex1 -interactionnonstopmode main.tex # 第三次编译解析所有交叉引用页码和目录稳定-interactionnonstopmode这个参数很关键默认交互模式下遇到第一个错误就停下来等用户按键这在批量编译时会导致进程挂住。加上它之后编译会跳过错误继续跑最后在日志里统一报错一次能看完所有问题。-synctex1建议每次都带反向同步在改长文档时极其好用尤其是导师在 PDF 上批注「第三章第二页图错了」时能直接跳回源码对应位置。四遍编译顺序不是玄学是因为 BibTeX 生成的 .bbl 文件需要第二次编译才能被正文引用填充而这会改变页数所以需要第三次编译固定页码。3.2 VSCode LaTeX Workshop用魔法注释锁定编译链如果你习惯 VSCodeLaTeX Workshop 插件是更好的选择。它的核心配置在.vscode/settings.json里直接写「魔法注释」让每个项目文件记住自己的编译链避免在多个模板间切换时每次都要改全局配置。{ latex-workshop.latex.recipes: [ { name: xelatex - bibtex - xelatex x2, 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: [%DOC%] } ] }%DOC%是 LaTeX Workshop 的内部变量指向当前打开的 .tex 文件。这样配置后在 main.tex 里按下 CtrlAltB 就会依次执行 xelatex、bibtex、xelatex、xelatex 四遍和手动执行结果一致。-file-line-error让错误信息带上「文件名:行号: 错误内容」的格式输出面板里可以直接点击跳转。在主文件第一行加魔法注释能进一步锁定编译器% !TeX program xelatex % !BIB program bibtex \documentclass[12pt, oneside, openany]{thesis}这两行是给编辑器看的不参与编译。TeXstudio 和 VSCode 都会读取它们用它指定的程序覆盖默认设置。我把这段配置发给过几个「Word 转 LATEX」的人他们遇到的最大问题不是配置不对而是装了多个 TeX 发行版导致命令行调用了错误版本的 xelatex。检查方法很简单where xelatex看输出路径确保只有一条。4. 避坑指南编译报错与格式不符的常见原因排查4.1 现象第一章编译通过第 4 章开始「Missing $ inserted」用过 LATEX 写论文的人几乎都撞过这个错误。表现为编译中断报错位置指向一段中文或特殊字符错误提示写着Missing $ inserted。原因这是典型的「中文出现在数学模式之外但被误判」或者更常见的情况——一段文字里出现了_、^这类数学符号。比如写「深度学习模型参数量_1.2M」时_在 LATEX 里被当成下标开始符必须在数学环境里才合法。解决办法是把特殊符号转义为文本形式。% 错误写法 模型参数量_1.2M % 正确写法 模型参数量\_1.2M % 中文引号也要用中文标点 % 错误写法: 深度学习 % 正确写法: “深度学习”排查时先看报错行上下文如果报错位置是章标题或章节命令后还可能是因为标题里直接用了数学符号。模板的章节标题使用了大字号加粗遇到_时默认尝试调起数学字体中文环境中没有配置数学字体才会报Missing $。4.2 现象参考文献全部显示问号[?] 替代了编号这是最常见的 bibtex 相关事故。表现为正文里引用显示[?]参考文献列表为空。原因通常有三层。第一层是只编译了一遍没有执行 bibtex第二层是 .bib 文件里条目格式有问题比如author字段少了花括号第三层是\bibliography{bib/ref}路径写错了bibtex 找不到 .bib 文件。排查时按顺序来# 第一步确保编译顺序完整 xelatex -interactionnonstopmode main.tex bibtex main xelatex -interactionnonstopmode main.tex xelatex -interactionnonstopmode main.tex # 第二步打开 main.blg 看 bibtex 日志 # 若提示 I couldnt open database file检查路径是否带拓展名 # \bibliography{bib/ref} 不是 bib/ref.bib模板默认把 .bib 放在 bib 文件夹下但有的版本\bibliography命令写的是ref而不是bib/ref。我建议直接改主文件统一写成不带.bib后缀的相对路径。cite命令的大小写也会导致匹配失败\cite{Li2023}和\cite{li2023}在 bibtex 大小写敏感的环境下是两条不同记录所以引用前最好先把 key 复制过来。4.3 现象中文字体报错正文字体变成宋体但标题变成黑体楷体混某高校模板在 Linux 或 macOS 上最容易踩字体坑。Windows 自带 SimSun 和 SimHei但 macOS 没有 SimSunLinux 更不可能有。XeLaTeX 找不到字体时ctex 宏包会尝试回退结果就出现标题和正文混用不同字族的情况。原因thesis.cls 里写死了\setCJKmainfont{SimSun}这类命令非 Windows 系统没有对应字体。解决办法是在编译选项中添加字体回退配置或者在导言区覆盖字体设置。% 在 main.tex 导言区添加优先级高于 cls 内的设置 \IfFontExistsTF{FandolSong}{ \setCJKmainfont{FandolSong} \setCJKsansfont{FandolHei} }{}Fandol 字体是 TeX Live 自带的免费中文字体一般安装在texlive/2024/texmf-dist/fonts/opentype/fandol下没有版权风险。如果你用的是 macOS可以用系统自带的「宋体-简」和「黑体-简」把字体名换成Songti SC和Heiti SC。用\IfFontExistsTF做条件判断后模板在 Windows 上继续用 SimSun在 macOS 和 Linux 上自动切换同一份代码在不同系统都能编译过。4.4 现象图片插入后跑到下一页位置完全不受控制LATEX 的浮动体机制经常让新手崩溃「图明明写在 2.3 节文字后面编译出来跑到 2.5 节去了。」这不是 bug是浮动体默认参数htbp各自有优先级和限制。原因模板或文档类里写死了[htbp]但hhere只是「这里试试」如果当前位置放不下LATEX 会把它推到下一节。解决有两个思路一是用[H]强制位置但不推荐用于大图二是调整浮动体限制参数。% 在导言区增加 \renewcommand{\topfraction}{0.9} \renewcommand{\bottomfraction}{0.9} \renewcommand{\textfraction}{0.08} \renewcommand{\floatpagefraction}{0.7}\topfraction控制页面顶部能放多少浮动内容默认 0.7改成 0.9 能减少被挤走的情况。但根本办法还是让图紧跟文字段落用\begin{figure}[htbp]的同时保证图片尺寸不要超过当前页剩余高度。模板编译日志里如果看到Float too large for page大概率就是图片宽高设置成了绝对尺寸改成\textwidth比例即可% 正确方式 \includegraphics[width0.8\textwidth]{fig1} % 错误方式 \includegraphics[width50cm]{fig1}4.5 现象目录中章节标题与正文标题不一致改过章节标题但目录里显示的还是旧名字。这是因为目录是编译时抓取的标签不会自动更新。解决办法是删掉旧的.toc和.aux文件重新完整编译三遍。rm main.toc main.aux main.bbl main.blg xelatex -interactionnonstopmode main.tex xelatex -interactionnonstopmode main.tex xelatex -interactionnonstopmode main.tex第一次编译生成章节标签第二次用标签生成目录第三次校准页码。换章节名后忘记删 .aux 是很多人的老毛病导致目录和正文凡是不一致优先检查这些缓存文件。5. 个性化改造按学校要求微调的四个入口5.1 从 12pt 到 14pt正文字号调整引发的连锁反应某高校模板默认正文字号是 12pt小四但有些学院要求「四号」或「五号」。直接在\documentclass里改字号参数是对的但要连带检查\baselineskip行距是否会显得过密。% 修改字号后如果行距太小在导言区增加 \linespread{1.4} % 参数范围 1.2~1.61.4 对应 Word 里的 1.4 倍行距改了正文字号后目录、页眉、页码里的字号不受\documentclass的 pt 参数影响因为它们是模板里单独定义的。如果导师反馈「目录里页码太大」需要去找 cls 文件里的\titlecontents相关段落手动覆盖字号。5.2 参考文献样式从数字编号到作者-年份制的切换有些专业用「作者-年份」制比如「张三 (2020)」而不是 [1]。模板大多默认国标数字制切换前先在 main.tex 里找到文献相关命令% 数字制默认 \bibliographystyle{bib/gbt7714-2015} % 作者-年份制需确认模板是否支持 % \usepackage[numbers]{natbib} % \bibliographystyle{bib/gbt7714-2015-n}这里最容易踩的坑是natbib宏包与模板内其他宏包的兼容性。如果用了gbt7714-2015.bst还想切作者年份制建议先备份改完重新执行 bibtex并在正文里把\cite{}换成\citep{}和\citet{}分别对应括号引用和叙述引用% \citet: 张三等 (2020) 提出... \citet{zhang2020} % \citep: 已有研究表明 (张三等 2020) \citep{zhang2020}5.3 页眉页脚去 Logo 加学院名的正确做法有的学院要求在页眉左侧放院徽图片右侧放论文题目。模板默认只有「某某高校硕士学位论文」一行文字。改动点在 cls 文件的\pagestyle相关段落。% 在 cls 文件中找到 \pagestyle{fancy} 后加入 \fancyhead[L]{\includegraphics[width2cm]{figures/logo.png}} \fancyhead[R]{\leftmark} % \leftmark 自动取当前章标题 \fancyfoot[C]{\thepage}改完重新编译后如果页眉出现锯齿或显示异常多半是图片像素太低。页眉图只建议用矢量 PDF 或 300dpi 以上的 PNG否则打印出来会模糊得不像话。页脚的页码如果不想显示在封面页需要在\begin{document}后立即加\pagenumbering{roman}把前段改成罗马数字正文才切回阿拉伯数字。这点很多模板已经处理好但个别版本会漏。5.4 数学公式行内公式与公式列表的排版习惯计算机和电子类专业必用公式。模板里公式排版依赖amsmath宏包默认支持但行内公式和独立公式列表的写法要讲究% 行内公式两边加 $注意与中文之间不要留空格 设损失函数为 $L -\sum_{i1}^{n} y_i \log p_i$其中 $p_i$ 为预测概率。 % 独立公式列表用 equation 环境自动编号 \begin{equation} L -\frac{1}{N} \sum_{i1}^{N} [y_i \log p_i (1-y_i) \log (1-p_i)] \label{eq:loss} \end{equation} % 引用公式 如公式~\eqref{eq:loss} 所示交叉熵损失用于衡量...~\eqref里的~是不断行空格保证「式」和「(5-3)」不会分到两行。公式里中文注释要用\text{}包裹直接写中文会报错。6. 提交盲审前强制执行的验证清单这一章我不讲新功能只讲一个动作——把模板从「能编译」变成「禁得起盲审老师拿放大镜看」。盲审格式检查项通常包括封面信息完整性、中英文摘要关键词数量、目录是否含三级标题、参考文献格式、图表编号连续性。我每次提交前都会在编译完成的目录下做三遍检查形成习惯后基本没有因为格式被退回。第一遍检查封面信息。用 PDF 阅读器把封面放大到 200%逐一比对姓名、学号、题目是否和系统里提交的一致。最容易出错的是题目里的中英文全角半角混用。模板里题目用的是\title{}命令如果复制自 Word引号常会变成弯引号或直引号编译后看起来没问题但字体渲染会不一致。我的做法是在\title{}里全部换成中文引号「」同时在外层用\texorpdfstring保证书签标题也正常。\title{基于\texorpdfstring{“深度学习”}{深度学习}的图像处理系统设计与实现}第二遍检查交叉引用是否全绿。在 TeXstudio 的「工具 → 日志」里看有没有undefined references警告如果有在 PDF 里定位到引用处确定是不是\ref{fig:xxx}的标签写错了。中文论文里标签建议统一用fig:、tab:、eq:前缀方便在几百行文件里快速检索。第三遍检查图表编号的连续性。打开 PDF 从第一章翻到附录把图 1-1、图 2-3、表 3-1 这种编号在纸上列出来确认没有跳号。LATEX 的图表编号和 Word 一样插入新图后后面所有图号会顺延但目录和正文里的交叉引用因为编译机制不同可能出现「目录里的图号对、正文里的不对」的情况这多半是\label和\caption的顺序写反了。% 正确顺序 \begin{figure} \includegraphics{fig1} \caption{系统架构图} \label{fig:architecture} \end{figure} % 错误顺序label 先于 caption会导致引用编号偏移从那以后我每次提交前都强制走一遍「编译清零——删 aux/toc——四遍完整编译——PDF 逐项核对」流程。哪怕只是改了一个标点符号也全部重来防的就是缓存文件里残留旧编号。希望这份模板的使用心能帮你在毕业季少熬几个夜把省下的时间用在真正需要动脑的实验和写作上。本文还有配套的精品资源点击获取 简介西北工业大学LaTeX论文模板依据学校官方格式整合面向硕士、博士研究生适用于学位论文、毕业设计等正式文档排版。模板内置公式快速排版、目录自动生成、图片浮动对齐等能力有效解决Word在公式和目录方面的反复调整问题同时支持学位类型切换并提供封面、声明、摘要、致谢、附录等模块满足盲审与定稿两种需求。针对本地编译较慢的情况可与Overleaf结合按章节在线编辑再回归离线LaTeX环境兼顾流畅性与最终PDF输出质量。压缩包共五十个文件大小约4.14MB核心内容包含样式宏包、示例论文、编译预览、字体库、参考文献格式、使用说明与示意图等并附带构建脚本便于按需修改。已有二百四十八人学习/下载适合希望摆脱Word排版限制、提升论文规范性的硕博研究生参考使用。1. 毕业设计排版救星一份能直接编译的 LATEX 论文模板每年毕业季总有人因为 Word 里一级标题变成黑体、页眉多了一条线、目录页码对不上熬到凌晨三点。用 LATEX 写毕业论文本质上是用「编译期的一次性痛苦」换「排版期的一劳永逸」但很多人卡在第一步模板不会选。某高校这份 LATEX 论文模板不是那种丢给你一堆 .sty 文件就完事的半成品而是能直接编译出符合学校格式要求的完整论文骨架覆盖封面、摘要、目录、正文、参考文献到附录全部环节。适合两类人一是受够 Word 排版玄学的本科生二是被导师要求「格式必须严格按学校规范来」的毕业设计作者。接下来我从 struct 到坑逐个讲清楚。2. 模板骨架拆解目录结构与主文件的参数逻辑2.1 从压缩包到编译成功目录结构与编译入口拿到模板压缩包后第一件事是看目录结构而不是急着编译。我拆过不少论文模板这份的目录设计比较清晰典型的 LATEX 项目布局. ├── main.tex % 主文件编译入口 ├── thesis.cls % 文档类格式核心 ├── bib/ │ ├── ref.bib % BibTeX 参考文献数据库 │ └── gbt7714-2015.bst % 国标参考文献样式 ├── figures/ % 插图目录支持 eps/pdf/png/jpg ├── chapters/ │ ├── abstract.tex % 中英文摘要 │ ├── chapter1.tex % 绪论 │ ├── chapter2.tex % 后续章节 │ └── appendix.tex % 附录 └── Makefile % 可选自动化编译脚本主文件 main.tex 的结构决定了整个编译流程。我建议直接改 main.tex不要动 thesis.cls因为文档类文件里封装了大量格式规则改错一个参数就可能让所有章节标题错位。\documentclass[12pt, oneside, openany]{thesis} % 12pt: 正文字号oneside: 单面打印openany: 章可从任意页开始 \usepackage[UTF8]{ctex} \graphicspath{{figures/}} \begin{document} \include{chapters/abstract} % 摘要部分 \include{chapters/chapter1} % 正文第一章 \include{chapters/chapter2} % 正文第二章 \include{chapters/appendix} % 附录 \end{document}这里\include和\input有本质区别\include强制分页适合一章一个文件\input不换页适合摘要、致谢这类短内容。毕业设计模板一般混用两者主文件里看到\include就知道是章节边界。\graphicspath命令把图片根目录指向 figures 文件夹这样正文里写\includegraphics{fig1}就能直接找到图不用每次写相对路径。12pt 对应 Word 里的「小四」是本科毕业设计最常见的正文字号如果学校要求「四号」改成 14pt 即可。2.2 二八法则学位类型与双盲审的开关藏在这里模板里最容易被忽略的是文档类\documentclass的那些可选参数。我见过有人把盲审版封面直接删掉结果提交盲审时被判定格式不符因为盲审版需要隐藏作者和导师信息而删掉封面会让页眉页码全部移位。\documentclass[12pt, oneside, openany, blind]{thesis} % blind 参数触发盲审模式自动隐藏作者/导师信息模板里一般会预留blind和final两个模式默认是final。答辩前提交盲审版本时把参数换成blind编译后封面和页眉里的作者、导师信息就会自动变成占位符——这是最省事的做法比手动删内容再调页码可靠得多。学位类型通常在 main.tex 里用自定义命令控制\degree{本科毕业设计} % 可选硕士学位论文 / 博士学位论文 / 本科毕业设计 \title{基于深度学习的某图像处理系统设计与实现} \author{某同学} \studentid{202000012345} \supervisor{某教授} \major{计算机科学与技术}这些信息会在封面、摘要页眉、声明页中被引用。改 title 和 author 时要检查是否有特殊字符比如英文标题里的_或在 LATEX 里直接写会编译报错需要转义为\_和\。我在帮人调试时遇到过一次中文标题里的破折号「——」在某些字体下编译出乱码最后改成两个--才正常。3. 编译环境配置TeXstudio 与 VSCode 的选型与实操3.1 Windows 下 TeXstudio最快跑通的编译链配置LATEX 模板落地最痛的不是语法而是编译环境。很多第一次用 LATEX 的人装了 TeX Live 后不知道需要经过「XeLaTeX → BibTeX → XeLaTeX → XeLaTeX」四遍编译直接在编辑器里点一次编译就报「Citation undefined」。下面按照最常见的 Windows 环境给出 TeXstudio 的可抄配置。# 假设已安装 TeX Live 2024检查 xelatex 是否在 PATH 中 xelatex -version # 若提示找不到命令需手动添加环境变量 # 典型安装路径C:\texlive\2024\bin\windows # 添加到 PATH 后重新打开终端打开 TeXstudio 后「选项 → 设置 TeXstudio → 构建」里要确认三件事默认编译器选 XeLaTeX默认文献工具选 BibTeX默认编码选 UTF-8。然后配置完成后的首次完整编译顺序在终端里手动执行一次最稳xelatex -synctex1 -interactionnonstopmode main.tex # -synctex1 生成反向同步文件Ctrl点击可从 PDF 跳回源码 bibtex main # 处理参考文献数据库生成 .bbl xelatex -synctex1 -interactionnonstopmode main.tex # 第二次编译写入参考文献交叉引用 xelatex -synctex1 -interactionnonstopmode main.tex # 第三次编译解析所有交叉引用页码和目录稳定-interactionnonstopmode这个参数很关键默认交互模式下遇到第一个错误就停下来等用户按键这在批量编译时会导致进程挂住。加上它之后编译会跳过错误继续跑最后在日志里统一报错一次能看完所有问题。-synctex1建议每次都带反向同步在改长文档时极其好用尤其是导师在 PDF 上批注「第三章第二页图错了」时能直接跳回源码对应位置。四遍编译顺序不是玄学是因为 BibTeX 生成的 .bbl 文件需要第二次编译才能被正文引用填充而这会改变页数所以需要第三次编译固定页码。3.2 VSCode LaTeX Workshop用魔法注释锁定编译链如果你习惯 VSCodeLaTeX Workshop 插件是更好的选择。它的核心配置在.vscode/settings.json里直接写「魔法注释」让每个项目文件记住自己的编译链避免在多个模板间切换时每次都要改全局配置。{ latex-workshop.latex.recipes: [ { name: xelatex - bibtex - xelatex x2, 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: [%DOC%] } ] }%DOC%是 LaTeX Workshop 的内部变量指向当前打开的 .tex 文件。这样配置后在 main.tex 里按下 CtrlAltB 就会依次执行 xelatex、bibtex、xelatex、xelatex 四遍和手动执行结果一致。-file-line-error让错误信息带上「文件名:行号: 错误内容」的格式输出面板里可以直接点击跳转。在主文件第一行加魔法注释能进一步锁定编译器% !TeX program xelatex % !BIB program bibtex \documentclass[12pt, oneside, openany]{thesis}这两行是给编辑器看的不参与编译。TeXstudio 和 VSCode 都会读取它们用它指定的程序覆盖默认设置。我把这段配置发给过几个「Word 转 LATEX」的人他们遇到的最大问题不是配置不对而是装了多个 TeX 发行版导致命令行调用了错误版本的 xelatex。检查方法很简单where xelatex看输出路径确保只有一条。4. 避坑指南编译报错与格式不符的常见原因排查4.1 现象第一章编译通过第 4 章开始「Missing $ inserted」用过 LATEX 写论文的人几乎都撞过这个错误。表现为编译中断报错位置指向一段中文或特殊字符错误提示写着Missing $ inserted。原因这是典型的「中文出现在数学模式之外但被误判」或者更常见的情况——一段文字里出现了_、^这类数学符号。比如写「深度学习模型参数量_1.2M」时_在 LATEX 里被当成下标开始符必须在数学环境里才合法。解决办法是把特殊符号转义为文本形式。% 错误写法 模型参数量_1.2M % 正确写法 模型参数量\_1.2M % 中文引号也要用中文标点 % 错误写法: 深度学习 % 正确写法: “深度学习”排查时先看报错行上下文如果报错位置是章标题或章节命令后还可能是因为标题里直接用了数学符号。模板的章节标题使用了大字号加粗遇到_时默认尝试调起数学字体中文环境中没有配置数学字体才会报Missing $。4.2 现象参考文献全部显示问号[?] 替代了编号这是最常见的 bibtex 相关事故。表现为正文里引用显示[?]参考文献列表为空。原因通常有三层。第一层是只编译了一遍没有执行 bibtex第二层是 .bib 文件里条目格式有问题比如author字段少了花括号第三层是\bibliography{bib/ref}路径写错了bibtex 找不到 .bib 文件。排查时按顺序来# 第一步确保编译顺序完整 xelatex -interactionnonstopmode main.tex bibtex main xelatex -interactionnonstopmode main.tex xelatex -interactionnonstopmode main.tex # 第二步打开 main.blg 看 bibtex 日志 # 若提示 I couldnt open database file检查路径是否带拓展名 # \bibliography{bib/ref} 不是 bib/ref.bib模板默认把 .bib 放在 bib 文件夹下但有的版本\bibliography命令写的是ref而不是bib/ref。我建议直接改主文件统一写成不带.bib后缀的相对路径。cite命令的大小写也会导致匹配失败\cite{Li2023}和\cite{li2023}在 bibtex 大小写敏感的环境下是两条不同记录所以引用前最好先把 key 复制过来。4.3 现象中文字体报错正文字体变成宋体但标题变成黑体楷体混某高校模板在 Linux 或 macOS 上最容易踩字体坑。Windows 自带 SimSun 和 SimHei但 macOS 没有 SimSunLinux 更不可能有。XeLaTeX 找不到字体时ctex 宏包会尝试回退结果就出现标题和正文混用不同字族的情况。原因thesis.cls 里写死了\setCJKmainfont{SimSun}这类命令非 Windows 系统没有对应字体。解决办法是在编译选项中添加字体回退配置或者在导言区覆盖字体设置。% 在 main.tex 导言区添加优先级高于 cls 内的设置 \IfFontExistsTF{FandolSong}{ \setCJKmainfont{FandolSong} \setCJKsansfont{FandolHei} }{}Fandol 字体是 TeX Live 自带的免费中文字体一般安装在texlive/2024/texmf-dist/fonts/opentype/fandol下没有版权风险。如果你用的是 macOS可以用系统自带的「宋体-简」和「黑体-简」把字体名换成Songti SC和Heiti SC。用\IfFontExistsTF做条件判断后模板在 Windows 上继续用 SimSun在 macOS 和 Linux 上自动切换同一份代码在不同系统都能编译过。4.4 现象图片插入后跑到下一页位置完全不受控制LATEX 的浮动体机制经常让新手崩溃「图明明写在 2.3 节文字后面编译出来跑到 2.5 节去了。」这不是 bug是浮动体默认参数htbp各自有优先级和限制。原因模板或文档类里写死了[htbp]但hhere只是「这里试试」如果当前位置放不下LATEX 会把它推到下一节。解决有两个思路一是用[H]强制位置但不推荐用于大图二是调整浮动体限制参数。% 在导言区增加 \renewcommand{\topfraction}{0.9} \renewcommand{\bottomfraction}{0.9} \renewcommand{\textfraction}{0.08} \renewcommand{\floatpagefraction}{0.7}\topfraction控制页面顶部能放多少浮动内容默认 0.7改成 0.9 能减少被挤走的情况。但根本办法还是让图紧跟文字段落用\begin{figure}[htbp]的同时保证图片尺寸不要超过当前页剩余高度。模板编译日志里如果看到Float too large for page大概率就是图片宽高设置成了绝对尺寸改成\textwidth比例即可% 正确方式 \includegraphics[width0.8\textwidth]{fig1} % 错误方式 \includegraphics[width50cm]{fig1}4.5 现象目录中章节标题与正文标题不一致改过章节标题但目录里显示的还是旧名字。这是因为目录是编译时抓取的标签不会自动更新。解决办法是删掉旧的.toc和.aux文件重新完整编译三遍。rm main.toc main.aux main.bbl main.blg xelatex -interactionnonstopmode main.tex xelatex -interactionnonstopmode main.tex xelatex -interactionnonstopmode main.tex第一次编译生成章节标签第二次用标签生成目录第三次校准页码。换章节名后忘记删 .aux 是很多人的老毛病导致目录和正文凡是不一致优先检查这些缓存文件。5. 个性化改造按学校要求微调的四个入口5.1 从 12pt 到 14pt正文字号调整引发的连锁反应某高校模板默认正文字号是 12pt小四但有些学院要求「四号」或「五号」。直接在\documentclass里改字号参数是对的但要连带检查\baselineskip行距是否会显得过密。% 修改字号后如果行距太小在导言区增加 \linespread{1.4} % 参数范围 1.2~1.61.4 对应 Word 里的 1.4 倍行距改了正文字号后目录、页眉、页码里的字号不受\documentclass的 pt 参数影响因为它们是模板里单独定义的。如果导师反馈「目录里页码太大」需要去找 cls 文件里的\titlecontents相关段落手动覆盖字号。5.2 参考文献样式从数字编号到作者-年份制的切换有些专业用「作者-年份」制比如「张三 (2020)」而不是 [1]。模板大多默认国标数字制切换前先在 main.tex 里找到文献相关命令% 数字制默认 \bibliographystyle{bib/gbt7714-2015} % 作者-年份制需确认模板是否支持 % \usepackage[numbers]{natbib} % \bibliographystyle{bib/gbt7714-2015-n}这里最容易踩的坑是natbib宏包与模板内其他宏包的兼容性。如果用了gbt7714-2015.bst还想切作者年份制建议先备份改完重新执行 bibtex并在正文里把\cite{}换成\citep{}和\citet{}分别对应括号引用和叙述引用% \citet: 张三等 (2020) 提出... \citet{zhang2020} % \citep: 已有研究表明 (张三等 2020) \citep{zhang2020}5.3 页眉页脚去 Logo 加学院名的正确做法有的学院要求在页眉左侧放院徽图片右侧放论文题目。模板默认只有「某某高校硕士学位论文」一行文字。改动点在 cls 文件的\pagestyle相关段落。% 在 cls 文件中找到 \pagestyle{fancy} 后加入 \fancyhead[L]{\includegraphics[width2cm]{figures/logo.png}} \fancyhead[R]{\leftmark} % \leftmark 自动取当前章标题 \fancyfoot[C]{\thepage}改完重新编译后如果页眉出现锯齿或显示异常多半是图片像素太低。页眉图只建议用矢量 PDF 或 300dpi 以上的 PNG否则打印出来会模糊得不像话。页脚的页码如果不想显示在封面页需要在\begin{document}后立即加\pagenumbering{roman}把前段改成罗马数字正文才切回阿拉伯数字。这点很多模板已经处理好但个别版本会漏。5.4 数学公式行内公式与公式列表的排版习惯计算机和电子类专业必用公式。模板里公式排版依赖amsmath宏包默认支持但行内公式和独立公式列表的写法要讲究% 行内公式两边加 $注意与中文之间不要留空格 设损失函数为 $L -\sum_{i1}^{n} y_i \log p_i$其中 $p_i$ 为预测概率。 % 独立公式列表用 equation 环境自动编号 \begin{equation} L -\frac{1}{N} \sum_{i1}^{N} [y_i \log p_i (1-y_i) \log (1-p_i)] \label{eq:loss} \end{equation} % 引用公式 如公式~\eqref{eq:loss} 所示交叉熵损失用于衡量...~\eqref里的~是不断行空格保证「式」和「(5-3)」不会分到两行。公式里中文注释要用\text{}包裹直接写中文会报错。6. 提交盲审前强制执行的验证清单这一章我不讲新功能只讲一个动作——把模板从「能编译」变成「禁得起盲审老师拿放大镜看」。盲审格式检查项通常包括封面信息完整性、中英文摘要关键词数量、目录是否含三级标题、参考文献格式、图表编号连续性。我每次提交前都会在编译完成的目录下做三遍检查形成习惯后基本没有因为格式被退回。第一遍检查封面信息。用 PDF 阅读器把封面放大到 200%逐一比对姓名、学号、题目是否和系统里提交的一致。最容易出错的是题目里的中英文全角半角混用。模板里题目用的是\title{}命令如果复制自 Word引号常会变成弯引号或直引号编译后看起来没问题但字体渲染会不一致。我的做法是在\title{}里全部换成中文引号「」同时在外层用\texorpdfstring保证书签标题也正常。\title{基于\texorpdfstring{“深度学习”}{深度学习}的图像处理系统设计与实现}第二遍检查交叉引用是否全绿。在 TeXstudio 的「工具 → 日志」里看有没有undefined references警告如果有在 PDF 里定位到引用处确定是不是\ref{fig:xxx}的标签写错了。中文论文里标签建议统一用fig:、tab:、eq:前缀方便在几百行文件里快速检索。第三遍检查图表编号的连续性。打开 PDF 从第一章翻到附录把图 1-1、图 2-3、表 3-1 这种编号在纸上列出来确认没有跳号。LATEX 的图表编号和 Word 一样插入新图后后面所有图号会顺延但目录和正文里的交叉引用因为编译机制不同可能出现「目录里的图号对、正文里的不对」的情况这多半是\label和\caption的顺序写反了。% 正确顺序 \begin{figure} \includegraphics{fig1} \caption{系统架构图} \label{fig:architecture} \end{figure} % 错误顺序label 先于 caption会导致引用编号偏移从那以后我每次提交前都强制走一遍「编译清零——删 aux/toc——四遍完整编译——PDF 逐项核对」流程。哪怕只是改了一个标点符号也全部重来防的就是缓存文件里残留旧编号。希望这份模板的使用心能帮你在毕业季少熬几个夜把省下的时间用在真正需要动脑的实验和写作上。本文还有配套的精品资源点击获取