0. 前言：写论文最痛苦的不是做实验，而是……

现在的你，是不是正处于以下某种“崩溃”状态？

场景一：蝴蝶效应
凌晨两点，论文初稿终于写完了。你发现第 3 章有一张图片稍微有点大，于是你轻轻地拖动了一下鼠标……
轰！
灾难发生了！第 4 章的标题莫名其妙跑到了上一页的页脚，参考文献的引用编号从 [15] 直接跳到了 [17]，原本对齐得好好的目录页码瞬间乱成了一锅粥。你不得不从头开始，像排雷一样一行行检查格式。
场景二：格式刷的奴隶
学校教务处发下来的《格式规范》厚达几十页：“一级标题黑体三号居中”、“正文宋体小四”、“行间距20磅”、“图注五号双语”……
你握着鼠标，疯狂点击“格式刷”，刷完第一章刷第二章，生怕漏掉一个标点符号。
场景三：盲审前的惊魂
导师突然通知：“明天就要交盲审版！把所有作者姓名、导师姓名、致谢部分全部删掉或打码！”
于是你另存了一个 main_盲审_最终版_打死不改版.doc，开始手动删除信息。结果交稿后才发现，页眉上还赫然写着“湖南农业大学硕士学位论文”，甚至英文摘要里还漏删了导师的名字……

够了！研究生的生命不应该浪费在调格式上！

如果我告诉你，有一种工具，能让你把 99% 的精力都集中在“写什么”（内容逻辑、实验数据、分析讨论），而把那令人头秃的 1% “怎么排版”（字体、字号、间距、页码）完全交给电脑自动处理，你愿意尝试一下吗？

这就是 LaTeX，以及本文要隆重介绍的主角——HUNAU-Thesis（湖南农业大学研究生学位论文 LaTeX 模板）。

为什么选择这个模板？

内容与格式分离：你只管写文字，LaTeX 负责把它们变成符合学校要求的漂亮排版。
一键“变身” ：只需修改一行代码，你的论文就能在“博士”、“学硕”、“专硕”之间切换；开启“盲审模式”，所有敏感信息自动隐藏，无需手动删减。
自动化神器：目录自动生成、图表自动编号（甚至附录里的图表也能自动变成“图附录1-1”）、参考文献自动排序。
专治强迫症：页眉页脚奇偶页自动区分，签名栏的下划线严格对齐，每一个像素都透着“专业”。

别听到“代码”两个字就想跑！现在的 LaTeX 早已不是那个只有程序员才能用的“黑底白字”了。

在接下来的文章中，我将用最通俗的大白话，手把手教你如何使用这个模板。无论你是零基础的小白（我们将使用像在线文档一样的 Overleaf），还是追求效率的高手（VS Code + Copilot），甚至是不想动脑的懒人（教你用 DeepSeek 和豆包帮写代码），这篇教程都能带你飞。

准备好了吗？让我们彻底告别 Word 排版的噩梦，开启优雅写论文的新世界！

1 模板亮点速览——为什么要用它？

既然 Word 也能写论文，为什么我们要费劲去用这个 LaTeX 模板？答案很简单：为了“偷懒” 。

HUNAU-Thesis 模板的设计初衷，就是把那些最耗时、最枯燥、最容易出错的“体力活”全部自动化。以下是它最核心的四大“超能力”：

1.1 多重身份，一键切换

在 Word 里，如果你想把一篇“学术型硕士论文”改成“专业学位硕士论文”，可能需要把封面、页眉、独创性声明全部手动改一遍。

但在本模板中，你只需要修改 main.tex 文件开头的一个单词：

代码段

% 我是博士，我要写博士论文
\documentclass[doctor]{hunau}

% 我是学硕，我要写学术型硕士论文
\documentclass[master]{hunau}

% 我是专硕，我要写专业学位论文
\documentclass[promaster]{hunau}

一秒钟，封面标题、页眉文字、声明页格式全部自动适配，丝般顺滑。

1.2 “盲审模式”：保命神器

这是本模板最受好评的功能之一。

每年的盲审季，都是打印店的噩梦。你需要手动删除封面的作者名、导师名，删掉致谢，检查页眉有没有露馅，甚至还要把个人简历里的名字改成“***”。

用本模板，你只需要在参数里加一个 blind：

代码段

% 开启盲审模式
\documentclass[master, blind]{hunau}

重新编译后：

封面/扉页：作者和导师姓名自动变为 ***，学号变为 ****。
致谢章节：自动整章消失。
个人简历：敏感信息自动打码。
页眉：自动隐藏任何可能暴露身份的信息。

你甚至不需要另存一个文件，随时可以切回正常模式。

1.3 自动化排版：专治强迫症

还记得被 Word 里的“页眉横线删不掉”和“页码奇偶页对不齐”支配的恐惧吗？

目录：写完章节，点一下编译，目录自动生成，页码永远准确。
页眉页脚：
- 前置部分（摘要、目录）：无页眉，页码居中（仅奇数页显示），偶数页自动留白。
- 正文部分：双线页眉，页码自动分布在切口侧（左页在左，右页在右），符合书籍印刷规范。
签名对齐：独创性声明页的签名下划线，无论你名字长短，永远严格对齐。

1.4 图表与附录的“高阶规矩”

学校规范里有一些让人头疼的细节要求，手动排版极难维护，但模板已经全搞定了：

双语标题：图表标题自动中英文对照（如：图2-1 上面是中文黑体，下面是英文 Times New Roman）。
三线表：预设了顶线、底线加粗，中间线细线的标准格式，告别丑陋的 Excel 截图。
附录编号：这是很多人的噩梦。正文是“图 2-1”，附录里要求是“图附录1-1”。本模板已内置特殊规则，进入附录后，所有图表公式的编号自动加上“附录X-”前缀，完全不用你操心。

看完这些，是不是觉得手里的格式刷突然就不香了？

别急，接下来我们将进入第二部分，手把手教你如何搭建环境，把这个强大的模板跑起来！

没问题！这是为您精心撰写的 第二部分：新手上路——环境搭建与项目运行。

这一部分是无数新手被“劝退”的重灾区。为了确保哪怕是电脑小白也能一次跑通，我将步骤拆解到了“保姆级”的颗粒度，并预判了几乎所有可能出现的“坑”。

2 新手上路——环境搭建与项目运行

LaTeX 的劝退通常不在语法，而在配环境。
“为什么我的编译器报错？”“为什么缺少字体？”“为什么参考文献全是问号？”……

别慌！为了照顾不同需求的同学，我提供了三种方案。请根据你的情况“三选一”：

方案 A（在线版 - Overleaf） ：如果你不想下载几个 G 的安装包，网速不错，且电脑配置一般，选它！
方案 B（极客版 - VS Code） ：如果你追求极致的打字体验，想要本地离线写作，且不排斥稍微复杂的配置，选它！
方案 C（经典版 - TeXStudio） ：如果你想要本地运行，但不想折腾 VS Code 的插件配置，想要一个开箱即用的老牌软件，选它！

🟢 2.1 Overleaf —— 零配置，打开网页就能写（强烈推荐新手）

Overleaf 就像是“写论文界的腾讯文档”，所有环境都在云端配好了，你只需要注册个账号。

第一步：注册与创建

打开 Overleaf 官网。
注册并登录（建议用邮箱注册）。
点击左上角的 "New Project" (新建项目) -> "Upload Project" (上传项目)。
将下载好的模板压缩包（hunau-thesis.zip）直接拖进去。

第二步：关键设置（不做这步必报错！）

项目打开后，你可能会看到满屏红色报错，或者中文乱码。这是因为 Overleaf 默认的编译器不支持中文。

点击页面左上角的 "Menu" (菜单) 按钮。
在下拉菜单中找到 "Compiler" (编译器)。
【关键操作】 将默认的 pdfLaTeX 切换为 XeLaTeX。

为什么要改？因为只有 XeLaTeX 才能完美处理中文排版和系统字体。

第三步：解决“字体缺失”大坑

我们的模板默认调用 Windows 系统的 SimSun (宋体) 和 SimHei (黑体)。Overleaf 的服务器是 Linux 系统，没有这些字体。

表现：编译报错 Font family 'SimSun' not found。
解决方法：

在你的 Windows 电脑中找到 C:\Windows\Fonts 文件夹。
复制 simsun.ttc (宋体)、simhei.ttf (黑体)、times.ttf (Times New Roman) 等文件出来。
在 Overleaf 项目左侧文件栏，新建一个文件夹叫 fonts。
点击 Upload，把这几个字体文件上传到 fonts 文件夹里。
(模板已内置逻辑) 只要字体文件在，XeLaTeX 就能直接调用。

第四步：编译

点击绿色的 "Recompile" 按钮。几秒钟后，右侧就会显示漂亮的 PDF 预览了！

🔵 2.2 VS Code + LaTeX Workshop —— 颜值与效率的巅峰

这是目前程序员和科研大佬最爱用的组合。虽然配置稍烦，但一旦配好，写作体验极其丝滑。

第一步：安装 TeX 发行版（地基）

你需要先安装 LaTeX 的“内核”。

Windows 用户：下载并安装 TeX Live（推荐下载 ISO 镜像文件，右键装载后运行 install-tl-windows.bat）。
注意：安装包约 8GB，安装时间可能长达 1 小时，请耐心等待直到出现“欢迎进入 TeX Live 的世界”。
macOS 用户：下载并安装 MacTeX。

第二步：安装 VS Code 及插件

下载安装 Visual Studio Code。
点击左侧侧边栏的“方块”图标（扩展商店），搜索并安装 LaTeX Workshop 插件。

第三步：配置自动化编译链（最容易翻车的地方）

学位论文需要处理参考文献，所以编译顺序必须是：XeLaTeX -> Biber -> XeLaTeX -> XeLaTeX。如果手动点四次，你会疯的。我们需要配置“一键全自动”。

在 VS Code 中按下 Ctrl + Shift + P (Mac 是 Cmd + Shift + P)。
输入 Preferences: Open Settings (JSON) 并回车，打开配置文件。
【直接抄作业】 将以下代码粘贴到大括号 { ... } 中（注意上一行末尾要加逗号）：

"latex-workshop.latex.tools": [
    {
        "name": "xelatex",
        "command": "xelatex",
        "args": [
            "-synctex=1",
            "-interaction=nonstopmode",
            "-file-line-error",
            "%DOCFILE%"
        ]
    },
    {
        "name": "biber",
        "command": "biber",
        "args": [
            "%DOCFILE%"
        ]
    }
],
"latex-workshop.latex.recipes": [
    {
        "name": "XeLaTeX -> Biber -> XeLaTeX*2",
        "tools": [
            "xelatex",
            "biber",
            "xelatex",
            "xelatex"
        ]
    }
],
"latex-workshop.latex.recipe.default": "XeLaTeX -> Biber -> XeLaTeX*2",

第四步：开始写作

用 VS Code 打开下载好的模板文件夹。
打开 main.tex。
点击左侧侧边栏的 TEX 图标，在 COMMANDS 下点击 Build LaTeX project。
点击右上角的“放大镜”图标 (View LaTeX PDF)，即可实现左边写代码、右边看预览的“所见即所得”效果。

🟠2.3 TeXStudio —— 经典怀旧，简单粗暴

如果你觉得 VS Code 太复杂，TeXStudio 是最稳妥的选择，界面虽然复古，但功能极其稳定。

第一步：安装

同样需要先安装 TeX Live（参考方案 B 第一步）。
下载并安装 TeXStudio。

第二步：关键配置

打开软件，点击菜单栏 Options -> Configure TeXstudio：

Build (构建) 选项卡：

Default Compiler (默认编译器) ：下拉选择 XeLaTeX。
Default Bibliography Tool (默认参考文献工具) ：下拉选择 Biber (千万别选 BibTeX，否则参考文献会报错)。

Editor (编辑器) 选项卡：

Encoding (编码) ：确保选择 UTF-8（否则中文全是乱码）。

第三步：运行

打开 main.tex，按 F5（构建并预览）。

⚠️ 高能预警：新手必读的“避坑指南”

无论你选哪种方案，以下 3 个问题只要遇到了，请先来这里找答案：

**编译报错 I can't write on file 'main.pdf'**

凶手：你用 WPS、Adobe Reader 或浏览器打开了 main.pdf 并且没关。
解法：PDF 阅读器会“独占”文件，导致编译器无法生成新的 PDF。关掉阅读器，或者使用 VS Code/TeXStudio 自带的内置阅读器，再次编译即可。

参考文献变成了 [?] 或者引用列表是空的

凶手：只运行了 XeLaTeX，没运行 Biber。
解法：LaTeX 处理引用需要四步走。如果你用了 方案 B 的配置代码，它会自动处理。如果是手动编译，请确保执行顺序是：XeLaTeX (生成框架) -> Biber (处理文献数据) -> XeLaTeX (插入文献) -> XeLaTeX (修正页码)。

路径或文件名包含中文/空格

现象：莫名其妙报错，找不到文件。
解法：虽然现在的 TeX 引擎改进了很多，但为了保命，请确保项目文件夹路径全都是英文，例如 D:\MyThesis\，尽量不要用 D:\我的论文\最终版 v3\。

好的，这是为您撰写的 第三部分：写作指南——基础填空。

这一部分是核心实操环节。为了让农业类研究生更有代入感，我特意设计了诸如“油菜产量分析”、“光合速率测定”、“土壤成分检测”等具体的农业科研场景作为示例，确保读者能直接复制粘贴即用。

3 写作指南——基础填空

环境配好了，现在我们要开始“填空”了。

LaTeX 的写作逻辑就像做实验：main.tex 是你的实验方案（总控），chapters/ 文件夹里的文件是具体的实验记录（内容）。

3.1 门面担当：填写论文基本信息

打开 main.tex 文件，你会看到这部分代码。这是全篇论文的“身份证”，请照着填空：

代码段

% === 1. 论文信息录入 ===
\title{基于深度学习的油菜角果表型高通量分析} % 中文题目
\entitle{High-throughput Phenotyping of Rapeseed Silique Based on Deep Learning} % 英文题目
\author{袁小隆}           % 作者姓名
\studentnumber{20230001} % 学号
\mentor{李四}            % 导师姓名
\mentortitle{教授}       % 导师职称
\major{作物遗传育种}      % 学科专业
\researcharea{智慧农业}   % 研究方向

% 基金支持（如果是空白，页面底部就不会显示）
\fund{本研究得到国家自然科学基金（编号：31870000）资助。}

% 答辩信息（扉页用）
\defensedate{2025年5月28日}
\chair{王五 教授}
\reviewer{张三 教授、李四 研究员}

✨ 避坑提示：如果你的题目特别长，想手动换行，可以在换行处加 \\，例如 基于深度学习的\\油菜角果表型分析。

3.2 正文写作：搭积木

正文内容都放在 chapters 文件夹里。我们在 main.tex 里通过 \include 命令把它们拼起来：

代码段

\mainmatter
\include{chapters/chapter1} % 绪论
\include{chapters/chapter2} % 材料与方法
\include{chapters/chapter3} % 结果与分析

写每一章时，层次结构如下：

代码段

\chapter{材料与方法}
  \section{试验材料}
    本试验所用油菜品种为湘油1号...
  \section{田间管理}
    \subsection{施肥方案}
      氮肥施用量为...

3.3 图表进阶：农业论文的“颜值核心”

农业论文少不了田间照片、显微结构图和复杂的数据表。

(1) 插入图片：双语标题是关键

学校规定：图题必须中英文对照。本模板已经集成了 \bicaption 命令，自动帮你搞定格式（中文黑体，英文罗马体）。

场景：插入一张田间试验小区的照片

代码段

\begin{figure}[htbp]
    \centering
    % width=0.8\textwidth 表示图片宽度占页面宽度的80%
    \includegraphics[width=0.8\textwidth]{images/field_trial.jpg}
    % \bicaption{中文标题}{英文标题}
    \bicaption{不同氮肥处理下的油菜田间长势}{Field growth of rapeseed under different nitrogen treatments}
    \label{fig:field_growth} % 给图片起个代号，方便文中引用
\end{figure}

在文中引用时，只需要写： “如图 \ref{fig:field_growth} 所示...”

(2) 插入组图：处理组 vs 对照组

农业研究常需要对比。比如左边是“正常叶片”，右边是“缺素叶片”。我们要用到 minipage（迷你页）功能。

代码段

\begin{figure}[htbp]
    \centering
    % 左边的图
    \begin{minipage}[b]{0.48\textwidth}
        \centering
        \includegraphics[width=\textwidth]{images/leaf_ck.png}
        \centerline{(a) CK (对照)}
    \end{minipage}
    \hfill % 中间加点弹簧，撑开距离
    % 右边的图
    \begin{minipage}[b]{0.48\textwidth}
        \centering
        \includegraphics[width=\textwidth]{images/leaf_stress.png}
        \centerline{(b) Stress (胁迫)}
    \end{minipage}
    \bicaption{干旱胁迫对油菜叶片气孔形态的影响}{Effect of drought stress on stomatal morphology of rapeseed leaves}
    \label{fig:stomata}
\end{figure}

(3) 三线表：告别 Excel 截图

千万不要把 Excel 截图贴进论文里！那样会被盲审专家直接打回。请使用标准的三线表代码。

场景：展示不同品种的产量构成因子

代码段

\begin{table}[htbp]
    \centering
    \bicaption{不同油菜品种的产量及构成因素}{Yield and yield components of different rapeseed varieties}
    \zihao{5}\songti % 表内字号要求五号
    \begin{tabular}{lcccc} % l=左对齐, c=居中
        \toprule  % 顶线（粗）
        品种 & 单株角果数 (个) & 每角粒数 (粒) & 千粒重 (\unit{g}) & 产量 (\unit{kg/ha}) \\
        \midrule  % 中线（细）
        湘油1号 & 320.5 $\pm$ 15.2 & 22.5 $\pm$ 1.2 & 3.85 & 2450.5 \\
        中双11号 & 345.2 $\pm$ 18.6 & 21.8 $\pm$ 1.5 & 4.02 & 2560.8 \\
        \bottomrule % 底线（粗）
    \end{tabular}
\end{table}

(4) 卧排表：超宽大表的救星

做全基因组关联分析（GWAS）或多点试验的同学，表格往往很宽。如果页面竖着放不下，可以用 sidewaystable 环境。模板会自动处理：奇数页表头朝订口，偶数页表头朝切口（不用你操心方向）。

代码段

\begin{sidewaystable}[htbp]
    \centering
    \bicaption{多环境下的油菜农艺性状统计}{Statistics of agronomic traits...}
    \begin{tabular}{...}
        ...
    \end{tabular}
\end{sidewaystable}

3.4 公式与单位：显摆专业的时刻

Word 里的公式编辑器虽然好用，但在处理单位时经常不规范。LaTeX 的 siunitx 宏包是科研界的各种标准。

带误差的数值：
- Word 写法：165.4 ± 5.2 cm (还得找±号在哪)
- LaTeX 写法：\qty{165.4 +- 5.2}{\cm}
- 效果：数字和单位间距自动调整，正负号自动对齐。
复杂的复合单位：
- 场景：光合速率单位（微摩尔每平方米每秒）
- LaTeX 写法：\qty{25.6}{\micro\mole\per\meter\squared\per\second}
- 效果：自动生成 \mu mol \cdot m^{-2} \cdot s^{-1}，极其标准。
科学计数法：
- LaTeX 写法：\num{3.5e-7} -> 3.5 \times 10^{-7}

3.5 参考文献：全自动排序

你还在手动调整 [1], [2] 的顺序吗？如果我在第一段插入了一篇新文献，后面的几百篇都要重排？

在 LaTeX 里，你只需要维护一个 references.bib 文件：

去百度学术或谷歌学术，搜索文献。
点击“引用” -> “BibTeX”，复制那段代码。
粘贴到 references.bib 文件中。
在文中需要引用的地方写 \cite{zhang2023}。

编译时，LaTeX 会根据国标 GB/T 7714-2015 自动排序、自动生成文末的参考文献列表。

3.6 附录：自动化的最后一块拼图

对于补充的图表数据，只需在 main.tex 里开启附录模式：

代码段

\appendix
\include{chapters/appendix}

在 appendix.tex 里插入的图表，编号会自动变成 “表附录1-1” 、 “图附录1-1” ，并且会自动出现在目录后面的“附表清单”中。你不需要做任何额外设置！

4 效率开挂——在线工具与 AI 辅助

“道理我都懂，但是 LaTeX 的表格代码 & \\ \hline 看起来真的像乱码，手写太痛苦了怎么办？”

“公式里的积分号、希腊字母命令记不住怎么办？”

时代变了，大人！

现在写 LaTeX，只有 10% 的时间是在敲代码，剩下 90% 的时间是在使用工具和调教 AI。这里给你推荐几款“作弊级”神器，让你的效率直接起飞。

4.1 表格神器：TableConvert —— Excel 直接转代码

你还在对着 Excel 表格，一行行手动敲 LaTeX 代码吗？快停下！

神器名称：TableConvert
传送门：https://tableconvert.com/zh-cn/excel-to-latex
推荐理由：它是目前对“三线表”支持最好的在线工具。

傻瓜式操作步骤：

复制：在 Excel 或 WPS 里选中你的表格，Ctrl+C。
粘贴：打开网站，直接 Ctrl+V 粘贴到左侧编辑框。
设置（关键！） ：在输出区域的选项里，勾选 Booktabs（这对应学校要求的三线表格式）。
生成：右侧会自动生成一段漂亮的代码。
粘贴：把代码复制到你的 chapter 文件里即可。

4.2 公式神器：LaTeXLive —— 所见即所得

Word 的公式编辑器很好用，能不能像 Word 一样点点鼠标就生成 LaTeX 代码？能！

神器名称：LaTeXLive (妈叔出品)
传送门：https://www.latexlive.com/home
推荐理由：全中文界面，图标直观，支持图片识别。

使用技巧：

鼠标点击：像 Word 一样，点击 \sum、\int 等图标，自动生成代码。
图片识别：看到参考文献里有个复杂的公式不想敲？截图 -> 上传 -> 自动转成 LaTeX 代码。

4.3 终极杀器：用 DeepSeek / 豆包写代码（附模板专用提示词）

现在的国产大模型（如 DeepSeek、豆包、Kimi）写 LaTeX 的水平已经非常高了。

但是，如果你只对 AI 说“帮我写个表格”，它生成的代码往往不符合学校规范（比如缺了双语标题，或者用了丑陋的竖线）。

这里有一套针对 HUNAU-Thesis 模板的“咒语”（Prompt），请直接复制使用！

场景 A：把文字描述/Excel数据转成标准三线表

通用提示词（Prompt）：

请帮我写一个 LaTeX 表格代码，数据如下：

[在此处粘贴你的 Excel 数据或文字描述]

要求：

使用 booktabs 宏包的三线表格式（使用 \toprule, \midrule, \bottomrule）。

表格标题必须使用双语对照，命令为 \bicaption{中文标题}{English Title}。

表格内字体大小设置为 \zihao{5}\songti。

表格环境使用 table，居中对齐 \centering。

不需要提供 \documentclass 和 \begin{document}，只要表格部分的代码。

💡 效果演示：

AI 会直接吐出一段完美符合湖南农大格式的代码，你连 \bicaption 都不用自己改，直接填内容就行。

场景 B：生成复杂的公式

通用提示词（Prompt）：

请把以下数学公式转换为 LaTeX 代码：

[描述公式，例如：Y等于X的平方加上根号下Z，积分范围是0到无穷大]

要求：

使用 equation 环境（以便自动编号）。

如果包含单位，请使用 \unit{} 或 \qty{} 命令（基于 siunitx 宏包）。

给我一段可以直接粘贴到正文中的代码。

场景 C：处理超宽表格（卧排表）

通用提示词（Prompt）：

我有一个列数很多的表格，页面竖着放不下，需要使用卧排表（横向表格）。数据如下：

[粘贴数据]

要求：

使用 sidewaystable 环境（基于 rotating 宏包）。

同样使用 booktabs 三线表风格。

使用 \bicaption 添加双语标题。

字体五号宋体。

4.4 避坑小贴士：AI 的“胡言乱语”

AI 虽然强大，但有时候会“加戏”。在使用 AI 生成的代码时，请注意：

不要复制导言区：AI 经常会在代码开头加 \usepackage{...}。请删掉！ 我们的 hunau.cls 模板文件里已经把该装的宏包都装好了，重复加载会报错。你只需要复制 \begin{table} ... \end{table} 中间这部分。
检查双语标题：AI 翻译的英文标题可能不准确（比如把“油菜”翻译成 "Oil Vegetable"），请务必人工核对一下学术术语（应该是 "Rapeseed" 或 "Brassica napus"）。

5 高阶定制——做模板的主人

虽然模板已经把学校的“硬性规定”（如页边距、三号黑体章节名）锁死了，但作为一篇高水平的学位论文，你可能还有一些个性化的需求。

以下修改通常不会违反学校规定，但能让你的论文更符合你的学科习惯或导师喜好。

5.1 这种单位怎么打？——自定义学科专用单位

siunitx 宏包虽然内置了所有国际标准单位（kg, m, s），但在农学和生物学领域，我们经常会用到一些“非标”单位，比如：

bp (碱基对)
Da (道尔顿，蛋白分子量)
U (酶活力单位)
CFU (菌落形成单位)

如果在文中直接写字母，斜体和间距可能不规范。我们可以在 hunau.cls 文件中注册它们。

操作方法：

打开 hunau.cls，找到【常用单位注册】这一块（大约第 60 行左右），照葫芦画瓢：

代码段

% 原有代码：
\DeclareSIUnit\cm{cm}

% === 在这里添加你的新单位 ===
\DeclareSIUnit\bp{bp}   % 碱基对
\DeclareSIUnit\kb{kb}   % 千碱基
\DeclareSIUnit\Da{Da}   % 道尔顿
\DeclareSIUnit\U{U}     % 酶活力单位
\DeclareSIUnit\rpm{rpm} % 转速

使用效果：

在正文中写：质粒大小为 \qty{5.4}{\kb}，离心转速 \qty{12000}{\rpm}。

输出效果：数字与单位之间会有标准的窄空格，且单位字体 upright（正体），非常专业。

5.2 目录太长了怎么办？——控制目录深度

学校规范通常要求目录列出到三级标题（如 1.1.1），但如果你的论文结构特别深，或者导师觉得目录太长太啰嗦，只想显示到二级标题（如 1.1）。

操作方法：

在 main.tex 的导言区（\documentclass 之后，\begin{document} 之前），添加一行：

代码段

% tocdepth 控制目录显示的深度
% 1 = 只显示到节 (1.1)
% 2 = 显示到小节 (1.1.1) [默认值]
\setcounter{tocdepth}{1}

这样，目录会瞬间清爽，但正文中的编号不会受影响。

5.3 我是 Mac/Linux 用户？——跨平台字体配置

本模板默认是为 Windows 优化的，调用了系统自带的 SimSun (宋体)、SimHei (黑体)。

如果你在 macOS 或 Linux (如 Ubuntu) 下编译，可能会报错 font not found。

操作方法：

打开 hunau.cls，找到 === 2. 字体设置 === 部分（约 85 行）。你可以修改为该操作系统下对应的字体文件，或者使用 Fandol 字体集（TeXLive 自带的开源中文字体，全平台通用）。

代码段

% === 修改前 (Windows) ===
\setCJKmainfont[AutoFakeBold=true]{SimSun}

% === 修改后 (Mac/Linux 通用方案 - Fandol) ===
% 注意：需要确保你的 TeX 发行版完整安装了 fandol 字体包
\setCJKmainfont[AutoFakeBold=true]{FandolSong-Regular}
\setCJKsansfont[AutoFakeBold=true]{FandolHei-Regular}

5.4 参考文献想用“作者-年份”制？

虽然学校默认要求国标顺序编码制（[1], [2]），但部分社科类或特定的导师可能倾向于使用“作者-年份”制（Zhang et al., 2023）。

操作方法：

打开 hunau.cls，找到 biblatex 的宏包加载部分：

代码段

\RequirePackage[
    backend=biber,
    style=gb7714-2015, % <--- 修改这里
    ...
]{biblatex}

将 style=gb7714-2015 改为 style=gb7714-2015-ay (Author-Year)，重新编译后，文中的引用和文末的列表就会自动变成作者年份格式。

6 常见问题急救站 (FAQ)

在使用过程中，你可能会遇到以下“玄学”问题。请先别急着重装系统，看看这里：

Q1: 编译报错 xdvipdfmx:fatal: Unable to open "main.pdf"

诊断：这是最常见的问题！说明你的 main.pdf 文件正被另一个程序（如 Adobe Reader、WPS、浏览器）打开着。
处方：关闭所有 PDF 阅读器窗口。建议使用 VS Code 或 TeXStudio 内置的预览器，它们不会锁定文件。

Q2: 参考文献列表是空的，或者文中引用显示为 [?] 或 zhang2023

诊断：没有运行 biber 程序，或者编译次数不够。
处方：LaTeX 的引用机制需要“编译 tex -> 运行 biber -> 编译 tex -> 编译 tex”这四步。请参考第二部分的配置教程，确保你的编译器设置里包含了 biber。

Q3: 图片跑到了下一页，文字留了大片空白？

诊断：这是 LaTeX 的“浮动体”机制。它会尝试把图片放在排版最美观的位置，而不是你代码所在的位置。
处方：
1. 给 figure 环境加上 [htbp] 参数：\begin{figure}[htbp]（意思是：尽量放这里，不行就放顶端、底端或独立一页）。
2. 如果非要强制固定，加载 float 宏包后使用 [H] 参数（不推荐，容易导致页面底部出现大片空白）。

Q4: 附录的目录里显示“第附录1章”？

诊断：这是旧版本模板与 ctex 宏包的配置冲突。
处方：请确保你使用的是本文提供的最新版 hunau.cls (v4.14 及以上)，我们已经重写了附录的目录映射逻辑。

Q5: 复制 AI 给的代码报错 Undefined control sequence ？

诊断：AI 给的代码里用了一些需要加载额外宏包的命令（比如用了 \multirow 但没加载 multirow 包）。
处方：检查 hunau.cls 里的 RequirePackage 列表。如果缺失，手动在 main.tex 导言区添加 \usepackage{xxx}。

结语：工具是为思想服务的

写到这里，这篇长文教程就结束了。

或许你会觉得：“哇，LaTeX 好麻烦，还要配环境、写代码。”

但当你完成配置，开始写作时，你会发现：

你再也不用因为插入一张图片而整篇文档乱序；

你再也不用手动去改几百个参考文献的格式；

你再也不用担心盲审前因为漏删名字而被退稿。

HUNAU-Thesis 模板存在的意义，就是帮你屏蔽掉这些毫无意义的格式焦虑，让你把宝贵的发际线和精力，留给真正的科研思考。

🎓 祝各位 HUNAUers 论文顺利，盲审全 A，毕业快乐！

📥 资源下载

GitHub 仓库：

git:[@github/ethanchen0431/hunau-thesis]

0. 前言：写论文最痛苦的不是做实验，而是……

1 模板亮点速览——为什么要用它？

1.1 多重身份，一键切换

1.2 “盲审模式”：保命神器

1.3 自动化排版：专治强迫症

1.4 图表与附录的“高阶规矩”

2 新手上路——环境搭建与项目运行

🟢 2.1 Overleaf —— 零配置，打开网页就能写（强烈推荐新手）

第一步：注册与创建

第二步：关键设置（不做这步必报错！）

第三步：解决“字体缺失”大坑

第四步：编译

🔵 2.2 VS Code + LaTeX Workshop —— 颜值与效率的巅峰

第一步：安装 TeX 发行版（地基）

第二步：安装 VS Code 及插件

第三步：配置自动化编译链（最容易翻车的地方）

第四步：开始写作

🟠2.3 TeXStudio —— 经典怀旧，简单粗暴

第一步：安装

第二步：关键配置

第三步：运行

⚠️ 高能预警：新手必读的“避坑指南”

3 写作指南——基础填空

3.1 门面担当：填写论文基本信息

3.2 正文写作：搭积木

3.3 图表进阶：农业论文的“颜值核心”

(1) 插入图片：双语标题是关键

(2) 插入组图：处理组 vs 对照组

(3) 三线表：告别 Excel 截图

(4) 卧排表：超宽大表的救星

3.4 公式与单位：显摆专业的时刻

3.5 参考文献：全自动排序

3.6 附录：自动化的最后一块拼图

4 效率开挂——在线工具与 AI 辅助

4.1 表格神器：TableConvert —— Excel 直接转代码

4.2 公式神器：LaTeXLive —— 所见即所得

4.3 终极杀器：用 DeepSeek / 豆包写代码（附模板专用提示词）

场景 A：把文字描述/Excel数据 转成标准三线表

场景 B：生成复杂的公式

场景 C：处理超宽表格（卧排表）

4.4 避坑小贴士：AI 的“胡言乱语”

5 高阶定制——做模板的主人

5.1 这种单位怎么打？——自定义学科专用单位

5.2 目录太长了怎么办？——控制目录深度

5.3 我是 Mac/Linux 用户？——跨平台字体配置

5.4 参考文献想用“作者-年份”制？

6 常见问题急救站 (FAQ)

结语：工具是为思想服务的

📥 资源下载

[The Boy, the Mole, the Fox and the Horse] You're loved, and important

[TED] Taylor Swift speaks at NYU graduation ceremony in Yankee Stadium

Taylor Lee

场景 A：把文字描述/Excel数据转成标准三线表