`pkuthesis` 2.0：信科2025年本科生毕业论文LaTeX文档类

本文为2.x版本文档。关于1.x版本的pkuthesis文档，请见pkuthesis：信科2025年本科生毕业论文LaTeX文档类。

特性

尽可能模仿2025年信科毕业论文Word模板；
改了一些字体；
提供最小的功能；
易于修改，作者不希望文档类充斥着Plain TeX或LaTeX2e古神语；
主要满足作者本人的需求。

环境要求

请使用UTF-8编码撰写文档，TeX Studio用户请注意这一点。

在线环境

pkuthesis已在以下在线环境测试：

但请注意，Overleaf免费账号至多上传50 MB的.zip文件。建议您创建项目后，再上传fonts文件夹；

此外，Overleaf免费账号编译时间为20秒。为避免以上限制，建议您：

使用北大LaTeX，这是北大内网部署的Overleaf环境。但如果遇到停电、校园网故障或机房宕机，则无法使用。
使用TeXPage，其免费账号编译时间1分钟。
使用Cloud LaTeX，其免费账号编译时间2分钟。

无论您使用哪个在线环境，请经常性备份数据到本地。或者，您可以使用本地环境。

本地环境

操作系统

对于本地环境，pkuthesis已在Windows和Linux操作系统测试。

LaTeX发行版

推荐的LaTeX发行版为TeX Live 2025/2026，它应当附带所有必须的宏包。如果您认为TeX Live的体积太大、安装太慢，有以下方案可供选择：

（未经测试）使用MiKTeX发行版，它会在缺失宏包时自动安装。
（作者本人的方案）使用TinyTeX发行版，这是一个精简的TeX Live，缺失宏包时需要手动安装。您可以使用以下命令安装所需的最少宏包：

bash

tlmgr install ctex chinese-jfm fancyhdr footmisc bigfoot caption enumitem tabularray tocloft biblatex biblatex-gb7714-2015 xstring biber

TeX引擎

pkuthesis目前支持XeLaTeX和LuaLaTeX。

使用`pkuthesis`

从Release下载最新版本。截至本文撰稿时，最新版本是2.0.1。

text

│  ctex-fontset-pkuthesis.def
│  ctex-fontset-windows.def
│  example.bib
│  example.tex
│  example.pdf
│  PKU-Logo.pdf
│  pkuthesis.cls
│  thesis.bib
│  thesis.tex
└─ fonts
       -HYFangSongS.ttf
       -HYKaiTiS.ttf
       -Inter-Bold.otf
       ......

fonts文件夹为pkuthesis使用的字体；
PKU-Logo.pdf为北京大学校徽与中文校名；
pkuthesis.cls为文档类本身；
ctex-fontset-pkuthesis.def为字体配置文件；
example.tex、example.bib、example.pdf为示例文档；
thesis.tex、thesis.bib为最小示例，可以作为您论文的起点。

用户接口

使用\documentclass引入文档类。pkuthesis有以下用户接口：

使用\documentclass时的开关；
\ThesisInfo（用于设置标题等论文信息）和\ThesisStyle（用于设置标题格式等论文样式），这两个命令采用键值对风格。
\appendix和\acknowledgments，开始附录和致谢部分。

文档类开关

使用\documentclass引入文档类时，有如下三个开关：

centersec可以将一级标题由阿拉伯数字编号、左对齐，改为中文编号、居中对齐。

无centersec有centersec

latex

\documentclass{pkuthesis}

效果：

1. Section 1

  Lorem ipsum dolor sit amet, consectetur adipiscing
elit.Ut finibus lacus ut nunc porta euismod. Sed sit
amet ante vel enim tempus hendrerit eget eget erat.
Suspendisse tempor at purus vel tristique. Integer
urna turpis, auctor eget metus vel, rhoncus vehicula.

latex

\documentclass[centersec]{pkuthesis}

效果：

                 第一章 Section 1

  Lorem ipsum dolor sit amet, consectetur adipiscing
elit.Ut finibus lacus ut nunc porta euismod. Sed sit
amet ante vel enim tempus hendrerit eget eget erat.
Suspendisse tempor at purus vel tristique. Integer
urna turpis, auctor eget metus vel, rhoncus vehicula.

draft开关，在撰写草稿时，不插入实际图片，仅包含占位符，提升编译速度。
debug开关，为pkuthesis的开发调试用。

`\ThesisInfo`

用于设置论文信息。示例如下：

latex

\ThesisInfo {
    title  = {中文标题},
    title* = {英文标题},
}

所有字段如下：

标题：
- title = {中文标题}
- title* = {英文标题}
  论文标题。默认会自动断行，但为了语义的连贯以及排版的美观，如果您的标题长于一行，建议使用\\手动断行。
学生信息：
- author = {学生姓名（作者）}
- student-id = {学号}
- school = {学院名称}
- specialty = {专业名称}
摘要
- abstract = {中文摘要}
- abstract* = {英文摘要}
关键词：
- keywords = {中文关键词}
- keywords* = {英文关键词}
  关键词列表。请填写一个逗号分隔列表，后文将详细说明。

grade = {论文成绩（等级制）}
mentor-comments = {导师评语}

以上所有字段在不填写时，默认为空。

year = {年份}，填写阿拉伯数字。此键值对可以不填写，默认为编译时系统时间；
month = {月份}，填写阿拉伯数字。此键值对可以不填写，默认为5；

evaluation-form = {《导师评阅表》}，填写一个PDF文件路径。
填写此键值对时，该PDF文件的第一页将作为《导师评阅表》插入编译好的论文中。
不填写此键值对时，pkuthesis会自行绘制《导师评阅表》。
declaration-page = {《论文原创性声明和使用授权说明》}，填写一个PDF文件路径。
填写此键值对时，该PDF文件的第一页将作为《论文原创性声明和使用授权说明》插入编译好的论文中。
不填写此键值对时，pkuthesis会自行绘制《论文原创性声明和使用授权说明》。

以下几个字段填写导师信息。在不填写时，默认为空。

mentor/name = {导师姓名}
导师姓名。有多位导师时，请填写一个逗号分隔列表，后文将详细说明。
mentor/workplace = {导师单位/所在学院}
同样地，有多个字段时，请填写一个逗号分隔列表，后文将详细说明。
mentor/academic-rank = {导师职称}
有多个字段时，请填写一个逗号分隔列表，后文将详细说明。

在导师部分，除了使用“mentor/name”这种格式作为键之外，也可以将mentor部分作为一个块统一填写。以下两者是等同的：

latex

\ThesisInfo {
    mentor/name          = {千早爱音},
    mentor/workplace     = {羽丘女子学园},
    mentor/academic-rank = {吉他手},
}

latex

\ThesisInfo {
    mentor = {
        name          = {千早爱音},
        workplace     = {羽丘女子学园},
        academic-rank = {吉他手},
    },
}

提示

所谓逗号分隔列表，即外侧以花括号包裹，字段间以英文逗号隔开的列表。

latex

\ThesisInfo {
    mentor/name = {千早爱音, 安和昴},
}

必要时，为防止歧义，可以用花括号{...}把各成员字段括起来。示例：

latex

\ThesisInfo {
    mentor/name = {{千早爱音}, {安和昴}},
}

`\ThesisStyle`

\ThesisStyle用于配置论文格式。所有字段如下：

标题格式配置：
- title-format = {中文标题格式}
- title-format* = {英文标题格式}
pkuthesis对中、英文标题使用一号字，与教务模板保持一致。如果您认为字号太大，可以使用这两个字段修改：
latex
```
\ThesisStyle {
    title-format  = {\zihao{2}},
    title-format* = {\zihao{3}},
}
```
即中文标题使用二号字，英文标题使用三号字。
keywords-separator = {关键词分隔符}
可选的值为：comma（逗号）和semicolon（分号）。不填写时，默认为comma。
用于设置文档中关键词的分隔符。注意，这只会影响论文编译后PDF中的分隔符，在LaTeX源码中，关键词仍遵循上述“逗号分隔列表”。

提示

\ThesisInfo和\ThesisStyle在字段之间不可有空行：

latex

% 编译错误：
\ThesisStyle {
    title-format  = {\zihao{2}},

    title-format* = {\zihao{3}},
}

但字段内部可以，例如摘要和导师评语：

latex

\ThesisInfo {
    mentor-comments = {
        千早爱音同学的这篇论文深入探讨了键盘手在乐队中的重要性，选题新颖，论证充分。通过对《BanG Dream! It's MyGO!!!!!》和《Girls Band Cry》两部作品的细致分析，结合具体音乐表现案例，有力地支持了“乐队必须有键盘手”这一论点。

        论文结构严谨，语言流畅，展现了作者扎实的音乐理论功底和对乐队实践的深刻理解。尤其对《春日影》和《熙熙攘攘，我们的城市》的对比分析，见解独到，令人印象深刻。

        本论文达到了学士学位论文的优秀水平，同意提交答辩。
    },
}

字体配置

默认情况下，pkuthesis使用如下字体配置：

这由字体配置文件（ctex-fontset-pkuthesis.def）和字体文件（fonts/*）提供。

此外，在Windows系统下，您可以手动将pkuthesis源代码中的fontset = pkuthesis改为fontset = windows以启用如下字体配置：

三线表

pkuthesis提供了简易的三线表环境3-l-tablr，示例见example.tex。

对于复杂的三线表，建议您使用tabularray宏包自行绘制。更多信息见tabularray宏包的文档。

编译

pkuthesis支持的TeX引擎见前文所述。

您可以使用XeLaTeX以获得更高的编译速度；或使用LuaLaTeX以获得（可能）更好的兼容性，因为pkuthesis最初是为LuaLaTeX开发的，且目前优先在LuaLaTeX上测试。

Overleaf

左上角Menu > Settings > Compiler选XeLaTeX或LuaLaTeX。

本地环境

XeLaTeXLuaLaTeX

bash

xelatex thesis
biber thesis
xelatex thesis
xelatex thesis

bash

lualatex thesis
biber thesis
lualatex thesis
lualatex thesis

而如果您不关注交叉引用、目录和参考文献表，仅关注正文部分，那也可以只运行一遍TeX引擎以节省时间：

XeLaTeXLuaLaTeX

bash

xelatex thesis

bash

lualatex thesis

功能建议或报告错误

首选在Issues · Elkeid-me/pkuthesis打开新的议题。如果您有作者的QQ/微信，也可以直接联系作者。

声明

pkuthesis非北京大学官方制作，是作者个人为2025年信科本科毕设准备的。
pkuthesis使用的北京大学标志与中文校名组合（PKU-Logo.pdf）来自北京大学标识管理办公室。
pkuthesis使用了以下开源字体：
- Adobe发布的思源黑体和思源宋体。
- STI Pub发布的STIX Two。
- Rasmus Andersson发布的Inter。
- JetBrains发布的JetBrains Mono。
- FONTDASU发布的Shippori Mincho。pkuthesis使用其子集模仿中易仿宋的阿拉伯数字部分，用于排版学号。
此外，pkuthesis使用了闭源字体汉仪楷体和汉仪仿宋。使用pkuthesis意味着您同意《汉仪字库个人非商用须知》。
上述字体的文件名前添加-，以避免LuaLaTeX字体缓存冲突。

更新日志

2.0.1
1. 将思源系列字体由Language Specific的SC变体改为Region Specific Subset的CN变体。有助于解决LuaLaTeX下的字符编码问题，并减小打包大小。
2.0.0
1. 放弃upLaTeX支持，在字体配置中增加Slanted风格（但是Fake slanted）；
2. pdfkeywords现在跟随用户设定的分隔符；
3. 可以指定封面的年和月；不指定时，年为本机时间，而月为五月；
4. 支持插入PDF页为导师评阅表和原创性声明；
5. 脚注由1 ~ 9增加至1 ~ 50；
6. 新的基于Key-Value的用户接口：\ThesisInfo与\ThesisStyle；
7. 封面标题支持使用\\手动换行。
1.1.0
1. 升级思源黑体到2.005；
2. 修改封面标题的间距；
3. 导师评价现以\mentorComments定义，而不是\turtorComments。显然，这是作者在1.0.0版本中的疏漏；
  原有的\turtorComments仍然保留。
4. 更改字体配置。
1.0.0
1. 整理了代码；
2. 支持Linux，支持XeLaTeX，这意味着支持Overleaf；
3. 以STIX Two替换Nimbus Roman No. 9 L，以汉仪楷体替换华文楷体，以汉仪仿宋替换中易仿宋的中文部分，以Shippori Mincho替换中易仿宋的西文部分；
4. 微调了页边距；
5. 对upLaTeX的支持正在进行中。
1.0.0-rc4
1. 微调目录及图表caption的字号和行距；
2. 导师现以\mentor而不是\tutor定义；
3. 修复《学位论文使用授权说明》没有缩进的Bug。
1.0.0-rc3
1. 使用LaTeX3重写了用户接口；
2. 为hyperref包添加钩子。用户使用hyperref后，将会自动设置PDF元数据中的标题、作者和关键词。
3. 《毕业论文导师评阅表》的“导师评语”之上不再有空行。
4. 参考文献文件*.bib的基本名称遵循llmk的最佳实践。即原本是thesis.tex和ref.bib，现在是thesis.tex和thesis.bib。
5. 添加了llmk magic comment。现在可以用llmk <TeX文件名>编译文档。
1.0.0-rc2
1. 修复了“目录”二字中间没有\ccwd间距的Bug。
1.0.0-rc1
1. \paragraph后会新起一行，而不是该行后直接排版正文内容。即ctexart文档类的sub3section开关；
2. 引入centersec开关，当用户以\documentclass[centersec]{pkuthesis}使用文档类时，\section将会居中，且编号以类似“第一章”的格式显示。
0.4.3
1. 修复了作者打错字体名的Bug（应为JetBrains Mono NL，不是JetBrains Mono NF）。
0.4.2
1. 调整《毕业论文导师评阅表》中导师签字和日期的缩进和间距。
0.4.1
1. 调整《毕业论文导师评阅表》中导师签字和日期的间距。
0.4.0
1. 添加《毕业论文导师评阅表》；
2. 对markdown包的实验性支持，不对其功能的完整性和正确性做任何保证。
0.3.0
1. 添加摘要、关键词、附录和致谢；
2. 参考文献的样式改用Hook解决；文档里奇怪的
  latex
```
\defbibheading{bibliography}[\refname]{
   \section*{#1}
   \addcontentsline{toc}{section}{#1}
   \vspace*{16.5pt}
}
```
  可以删掉了；
3. 三线表环境hqtblr。
0.2.1
1. 微调行距；
2. 恢复列表环境的topsep；
3. 目录后添加\clearpage，防止页码从目录的第二页开始。
0.2.0
1. 脚注在每一页从1重新编号；
2. 脚注使用带圈数字，代价是每页至多9个脚注。
添加了对footmisc和bigfoot包的依赖，TinyTeX用户可能需要手动安装。
0.1.0
1. 添加了《版权声明》和《论文原创性声明和使用授权说明》。
0.0.1
1. 表格的caption格式正确了；
2. \section的break改为\clearpage。
0.0.0
1. 初始版本。

特性 ​

环境要求 ​

在线环境 ​

本地环境 ​

操作系统 ​

LaTeX发行版 ​

TeX引擎 ​

使用pkuthesis ​

用户接口 ​

文档类开关 ​

\ThesisInfo ​

\ThesisStyle ​

字体配置 ​

三线表 ​

编译 ​

Overleaf ​

本地环境 ​

功能建议或报告错误 ​

声明 ​

更新日志 ​

特性

环境要求

在线环境

本地环境

操作系统

LaTeX发行版

TeX引擎

使用`pkuthesis`

用户接口

文档类开关

`\ThesisInfo`

`\ThesisStyle`

字体配置

三线表

编译

Overleaf

本地环境

功能建议或报告错误

声明

更新日志