tuna/thuthesis · 上手攻略

  • 仓库：tuna/thuthesis
  • 链接：https://github.com/tuna/thuthesis
  • 分类：学术写作（LaTeX 模板）
  • 作者：spark
  • 更新：2026-07-15

是什么

ThuThesis 是清华大学 TUNA 协会维护的官方 LaTeX 学位论文模板，覆盖本科综合论文训练、学术型/专业型硕士、博士、博士后出站报告全部学位类型，并已支持苏世民书院变体。它不是一份空白样式文件，而是一整套 .cls + .def + .bib 配套的工程：从封面、声明页、授权页、中英文摘要、目录、章节、图表公式序号、参考文献（BibLaTeX 著者-出版年制 / 顺序编码制）、附录到最终 PDF 元数据全部按清华大学教务处和研究生院最新《写作指南》对齐。

最新发布版 v7.6.0（2026 年 4 月）完成了三件事：跟进教务处 2026 年 4 月更新版的本科生写作指南；同步 2025 年 3 月研究生写作指南（声明页加涉密提示、授权页引用《学位法》替代旧的《学位条例暂行实施办法》）；新增苏世民学院（Schwarzman）格式变体开关 style-override=schwarzman。

仓库采用 LPPL v1.3c 协议，校徽和校名 PDF（thu-fig-logo.pdf、thu-text-logo.pdf）受清华大学视觉形象系统商标约束，只能用于制作本校论文封面，不能挪作他用。

解决什么问题

  • 教务处和研究生院的 Word 模板格式细节繁多（页眉页脚、章节断页、表格字号、参考文献悬挂缩进……），手写 LaTeX 极易踩坑；ThuThesis 把这些规则固化到 .cls 里。
  • 学位类型多（本科/学硕/专硕/博士/博后），不同类型的封面信息、声明页、授权页格式都不一样，模板通过 \documentclass[type=...] 一行切换。
  • 学院变体（苏世民、生命科学等）有专属样式，传统做法是 fork 改 cls，现在用 style-override 等选项即可。
  • 长期维护 + 自动化测试：GitHub Actions 在多平台（Windows / macOS / Linux）跨 TeX 发行版（TeX Live、MikTeX）跑 CI，每次合并都重新构建示例文档，并通过 Test workflow 自动产出 thuthesis-snapshot-release 供人下载开发版。

快速安装

方式 1：下载发布版（推荐 · 几乎所有人从这里开始）

# 从 GitHub Releases 拉最新版（当前 v7.6.0）
wget https://github.com/tuna/thuthesis/releases/download/v7.6.0/thuthesis-v7.6.0.zip
unzip thuthesis-v7.6.0.zip
cd thuthesis-v7.6.0
# 官方提供的 Makefile 一键生成示例论文与模板文档
make thesis   # 生成 thuthesis-example.pdf
make doc      # 生成模板使用说明书 thuthesis.pdf

国内加速可走清华 TUNA 镜像：https://mirrors.tuna.tsinghua.edu.cn/github-release/tuna/thuthesis/，文件名同 GitHub Releases。

方式 2：TeX 发行版工具（适合想保持模板随发行版自动更新的用户）

# TeX Live 用户
sudo tlmgr update thuthesis

# MikTeX 用户（Windows）
mpm --update thuthesis

CTAN 同步通常滞后正式发布几个工作日，需要新特性请走 GitHub Releases。

方式 3：Overleaf / TeXPage

  • Overleaf：cfwgcxtvkbsx。注意 Overleaf 已降低免费账户编译时间，ThuThesis 因为依赖较重容易超时（issue #984），建议付费或自建。
  • TeXPage：72b580ca-...，附带 Windows 中文字体，适合没有本地 TeX 环境的同学。

方式 4：开发版（开发者或需要尚未发布的功能）

git clone https://github.com/tuna/thuthesis.git
cd thuthesis
xetex thuthesis.ins          # 从 .dtx 生成 .cls 和 .def
make thesis

或直接去 GitHub Actions 对应 commit 的 Test workflow 下载 thuthesis-snapshot-release，解压后 dist/ 目录就是已编译好的开发版。

核心用法

1. 复制示例文件并改名

cp thuthesis-example.tex my-thesis.tex
# 编辑 my-thesis.tex：把个人信息、学院、导师、摘要填进去

2. 选择学位类型

% 本科综合论文训练
\documentclass[type=bachelor]{thuthesis}

% 学术型硕士
\documentclass[type=master]{thuthesis}

% 专业型硕士
\documentclass[type=master, professional]{thuthesis}

% 博士
\documentclass[type=doctor]{thuthesis}

% 博士后出站报告
\documentclass[type=postdoc]{thuthesis}

% 苏世民学院（v7.6.0+）
\documentclass[type=master, style-override=schwarzman]{thuthesis}

3. 封面与基本信息

\thuthesisinfo{
 分类号         = TP311,
 密级           = 公开,
 UDC           = 004,
 题目           = 基于深度学习的某某方法研究,
 题目英文       = Research on ...,
 姓名           = 张三,
 学号           = 2021XXXXXX,
 学院           = 计算机科学与技术系,
 专业           = 计算机科学与技术,
 指导教师       = 李四 教授,
 副指导教师     = 王五 副教授,
 联合指导教师   = 赵六,
 答辩日期       = 2026-05-20,
 培养单位       = 清华大学,
 专业学位类别   = （专硕用）,
 研究方向       = 机器学习,
}

4. 参考文献（BibLaTeX 著者-出版年制 / 顺序编码制）

模板默认用 BibLaTeX，可在 \documentclass 里切换：

\documentclass[type=master,
  biblatex-style=authoryear,    % 著者-出版年制（默认）
  % biblatex-style=numeric,    % 顺序编码制
]{thuthesis}

\addbibresource{refs.bib}

% 正文引用
\citet{key1}      % 著者-出版年制：作者(年)
\parencite{key1}  % 著者-出版年制：(作者 年)
\cite{key2}       % 顺序编码制：编号

% 末尾打印参考文献表
\printbibliography

本科生的附录（调研阅读报告 / 书面翻译）从 v7.5 起也支持 BibLaTeX（issue #893），编译命令改为 bibtex thuthesis-appendix-{a,b,c...}。

5. v7.6.0 新增的格式控制选项

\documentclass[type=bachelor,
  footnote-style    = plain,        % circled（圈码）/ plain（普通）
  figure-numbering  = chapter,      % chapter（按章）/ global（全局）
  table-numbering   = chapter,
  equation-numbering= chapter,
  footnote-numbering= chapter,      % page / chapter / global
]{thuthesis}

footnote-numbering、style-override 只能写在 \documentclass，不能写在 \thuthesisinfo。

6. 声明页 / 授权页

v7.5 之后声明页用 \statement 命令控制页眉页脚：

\statement[page-style=plain]   % 带页眉页脚（v7.6 默认）
\statement[page-style=none]    % 无页眉页脚

statement-page-numer 选项已被移除，请改用 \statement。

7. 编译流程

xelatex my-thesis.tex
biber my-thesis              # BibLaTeX 默认用 biber
xelatex my-thesis.tex
xelatex my-thesis.tex        # 解决交叉引用

或直接 make thesis。

典型适用场景

  • 清华在校生：本/硕/博/博后论文排版，不用二选一，直接用官方维护版。
  • 需要长期维护：模板每年跟着教务处和研究生院《写作指南》更新，避免自己 fork 漂移。
  • 多学位类型混合：组里同时有本科毕设、硕士、博士开题报告，模板统一。
  • 跨学院变体：苏世民学院、生命科学学院（Cell 参考文献格式）等通过选项切换，不必维护多套 fork。
  • 在线写作：通过 Overleaf / TeXPage 与导师/同学协作。

坑与注意

  1. 模板升级频繁：维护者明确要求"开始使用和提问前，请认真完整地阅读使用说明文档和示例代码"。每升一次版本，部分命令会被废弃（如 statement-page-numer、degree-name、toc-chapter-style、带星号的 \listoffigures*、\listofequations 与 \equcaption）。升级前看 CHANGELOG.md。
  2. Overleaf 编译超时：ThuThesis 依赖较重，免费账户容易超时（issue #984），临时方案是删一些无用示例文件或升级付费。
  3. 编译引擎：默认 XeLaTeX，不要随意切到 pdfLaTeX（中文会乱）。LuaLaTeX 在 v7.5 之后部分符号错误使用西文字体的问题已修（PR #1022），但仍有零星问题，建议 XeLaTeX 优先。
  4. 校徽商标：清华校徽和校名图形是注册商标，只能用于制作本校论文封面。改了 logo 颜色、挪到非清华场景、放到 GitHub README 当 demo，都算违规。
  5. 非官方分发：任何"thuthesis 变体""清华论文模板 XX"都不是官方版本，CTAN / GitHub Releases / TUNA 镜像三个渠道是权威源。
  6. 开发版无保证：master 分支可能随时回滚，生产论文请用发布版（CTAN 滞后，GitHub Releases 即时）。
  7. 支持路径：先看 FAQ，再 Discussions 搜，确认是 bug 才在 Issues 用模板提。入门问题请看新手指南。
  8. 许可证：项目本身是 LPPL v1.3c，但若违反许可证使用（比如不署名、闭源商用修改版本），会被记到耻辱柱。

与同类对比

  • 清华 Word 官方模板：教务处和研究生院各发一份，胜在"官方原生"，缺点是格式细节手调、改起来痛苦、不能版本控制。ThuThesis 的存在意义就是把同一份规范以代码形式固化下来。
  • ctexbook / book 类 + 自己定制：灵活，但要自己实现封面、声明页、授权页、参考文献悬挂缩进、PDF 元数据。写完一遍大概两三天，改一版规范又要两三天。ThuThesis 已经把这些都做了。
  • ustcthesis（中科大）/ BIT-thesis（北理工）等：兄弟院校的官方模板，结构类似，覆盖范围和更新频率各自不同。清华的 ThuThesis 在学位类型完整度（本科/学硕/专硕/博士/博后 + 苏世民）和活跃度（每月都有 issue/PR）上算头部。
  • overleaf-collection/thesis-templates：Overleaf 官方合集里只有一个 Thuthesis 入口，最终还是跳转到这个仓库。

一句话推荐结论

清华本/硕/博/博后写论文，就用 tuna/thuthesis 的 GitHub Releases 发布版，XeLaTeX + Biber，按学位类型选 \documentclass[type=...]，正文只管内容，格式问题交给官方维护者。