Universe

Create project in app

北京大学学位论文 Typst 模板（博士 / 硕士） | Typst Template (Doctoral / Master) for Peking University Thesis

Cover of an example thesis

一分钟快速体验

三行命令，立即生成一份完整的示例学位论文 PDF：

typst init @preview/pku-thesis-pass:0.3.1 my-thesis
cd my-thesis
typst compile thesis.typ

打开 thesis.pdf，即可看到一份包含封面、摘要、目录、正文、参考文献、致谢等全部要素的完整示例论文——无需任何配置。这份示例论文同时也是一份用户指南，按论文格式排版，边看边用。之后只需把 thesis.typ 中的示例信息替换成你自己的内容即可开始写作。

🎁 彩蛋：一条命令自动生成盲审版论文，隐藏封面个人信息、致谢与原创性声明等：

typst compile thesis.typ --input blind=true

完整能力见下文功能特性。

功能特性

  • 封面（正常版 + 盲审版）
  • 盲审模式自动隐藏封面个人信息与成果页、致谢、原创声明
  • 书脊页（打印装订用，盲审自动隐藏作者）
  • 版权声明页
  • 中英文摘要
  • 自动目录
  • 插图、表格、公式、代码列表、主要符号对照表
  • 中文章节编号（第X章 + 附录 A/B）
  • GB/T 7714 参考文献（2015 / 2025 标准）
  • 页眉页脚自动切换
  • 脚注
  • 三线表、长表跨页自动续表（“续” + 重复表头）
  • 公式块（编号 + 描述）、代码高亮、斑马条纹背景、编程语言名称图标
  • 子图（组合图 (a)(b)(c) 自动编号与交叉引用）
  • 定理环境（定理 / 定义 / 引理 / 推论 / 命题 / 性质 / 例 / 注 / 证明）
  • 附录
  • 攻读学位期间发表的论文（作者加粗 + SCI/EI/IF 标注）
  • 致谢、原创性声明
  • 中文交叉引用（@标签 自动生成如"图 1.1"式编号）
  • LaTeX 语法风格引用
  • 正文字数统计（wordometer，标题不计入）
  • 自动设置 PDF 元数据（标题 / 作者，盲审版隐藏作者）
  • 命令行参数控制（blind / preview / always-start-odd / system）
  • 跨平台字体方案（Windows / macOS / Linux）

获取模板

方式一：从 Typst Universe 创建（推荐）

typst init @preview/pku-thesis-pass:0.3.1 my-thesis
cd my-thesis

这会在 my-thesis 目录下创建一个包含 assets、content、ref.bib 和 thesis.typ 的干净项目。

方式二：克隆 GitHub 仓库

git clone https://github.com/chuxinyuan/pku-thesis-pass.git
cd pku-thesis-pass

如果需要完整的源代码对论文模板进行更多的定制，可以选择克隆仓库。其中，控制论文格式的源代码放在 format 目录下，模板放在 template 目录下。

配置说明

在 thesis.typ 中调用 config() 函数配置论文信息，返回值按字典形式访问，各组件可按任意顺序编排：

#let cfg = config(
  author-zh: "张三",
  title-zh: "论文中文题目",
  system: "windows",
)

#show: cfg.setup
#(cfg.cover)()

完整示例见 template/thesis.typ。

参数 类型 说明
author-zh str 中文姓名
author-en str 英文姓名
student-id str 学号
blind-id str 盲审论文编号
thesis-name str 论文类型（如"博士研究生学位论文"）
header-text str 页眉统一文本
title-zh str 中文题目
title-en str 英文题目
school str 院系
first-major str 一级学科
major-zh str 专业中文名
major-en str 专业英文名
direction str 研究方向
supervisor-zh str 导师中文名
supervisor-en str 导师英文名
degree-type str "academic" 或 "professional"
year int 提交年份
month int 提交月份
system str 系统字体方案："windows"/"macos"/"linux"
blind bool 盲审模式（默认false）
preview bool 预览模式（默认true）
first-line-indent length 首行缩进（默认2em）
always-start-odd bool 章节从奇数页开始（默认true）
clean-declaration bool 声明页隐藏页眉页脚（默认false）
outline-depth int 目录深度（默认3）
word-count bool 统计正文与附录字数（默认false），正文中可用 total-words / total-characters 显示统计结果
achievement-outlined bool "攻读学位期间发表的论文"页是否出现在目录（默认true）
supplements dict 自定义引用记号（图/表/代码/公式前缀）及列表标题（插图/表格/代码/公式列表、符号表、成果表）
use-latexref bool LaTeX 引用兼容（默认false）
latexref-prefixes array use-latexref 为 true 时尝试剥离的前缀列表
codly-args dict 代码块样式参数（行号、语言图标等）
logo path 封面校徽图片路径，如path("assets/logo.svg")（默认 none，显示占位框）
wordmark path 封面校名字标图片路径（默认none，显示占位框）
override-bib bool 自定义参考文献样式（默认false）
bib-file path BibTeX 文件路径，如path("ref.bib")
bib-style str "numeric" 或 "author-date"
bib-version str "2015" 或 "2025"
bib-cn-first bool 中文文献优先（默认true）
bib-pinyin-override dict 多音字校正，如("重": "chong2")

字体配置

模板为每个平台预定义了字体方案，通过 system 参数切换："windows" / "macos" / "linux"，默认使用 Windows 系统字体方案。

Typst 按列表顺序依次 Fallback，优先使用列表中靠前的字体。

Windows（system: “windows”）

Windows：使用系统自带字体

用途 字体列表
仿宋 Times New Roman, FangSong
宋体 Times New Roman, NSimSun
黑体 Times New Roman, SimHei
楷体 Times New Roman, KaiTi
代码 Consolas, NSimSun
英文衬线 Times New Roman
英文无衬线 Arial

macOS（system: “macos”）

macOS：使用系统自带字体

用途 字体列表
仿宋 Times New Roman, STFangsong
宋体 Times New Roman, STSong
黑体 Times New Roman, PingFang SC
楷体 Times New Roman, STKaiti
代码 Menlo, STSong
英文衬线 Times New Roman
英文无衬线 Helvetica

Linux（system: “linux”）

Linux：纯开源字体，无商业字体依赖

用途 字体列表
仿宋 Liberation Serif, FandolFang R, Zhuque Fangsong (technical preview)
宋体 Liberation Serif, Source Han Serif, Noto Serif CJK SC
黑体 Liberation Serif, Source Han Sans, Noto Sans CJK SC
楷体 Liberation Serif, AR PL UKai
代码 DejaVu Sans Mono, Source Han Serif, Noto Serif CJK SC
英文衬线 Liberation Serif
英文无衬线 Liberation Sans

注：FandolFang 字库不全，朱雀仿宋候补；Typst 目前对可变字体支持有限，优先使用 Adobe 发行的思源字体。

编译文档

这里以模板获取方式一（从 Typst Universe 创建）为例，代码如下：

# 普通版本
typst compile thesis.typ

# 盲审版本
typst compile thesis.typ --input blind=true

# 打印版本（链接不着色）
typst compile thesis.typ --input preview=false

# 章节不强制从奇数页开始
typst compile thesis.typ --input always-start-odd=false

# 指定系统字体方案（macOS/Windows/Linux）
typst compile thesis.typ --input system=linux

对于方式二（克隆 GitHub 仓库）的用户，进入 pku-thesis-pass 目录后，使用以下命令编译文档：

# 普通版本
typst compile template/thesis.typ --root .

需要特别注意的是，编译前需要仔细检查模板各模块的导入路径，例如，对于 template/content/ch01-quickstart.typ，它的文件头如下：

#import "../../format/lib.typ": code-block, booktab, font-set
// #import "@preview/pku-thesis-pass:0.3.1": code-block, booktab, font-set

未发布到官方仓库的改动需用本地相对导入（如上述 ../../format/...），以免 @preview 包与本地源码不一致。

致谢

感谢 pkuthss-typst 项目成员的杰出贡献，正是他们的卓越工作让北京大学学位论文排版变得简单而优雅。本模板在充分借鉴其理念与实现的基础上，借助 AI 辅助微调，最终形成了当前的论文模板。

许可证（License）

本项目中的 Typst 模板源代码依据 MIT 许可证进行授权。

模板内置的校徽（assets/pkulogo.pdf）和校名字标（assets/pkuword.pdf）文件取自 CTAN 的 pkuthss 包，属于受商标权、著作权保护的资源文件，不在 MIT 许可证授权范围内，其知识产权归相关权利人所有。上述资源仅限用于学位论文排版的学术、非商业用途，除法律法规另有规定或已获得相关授权外，不得对上述资源进行再分发、修改或用于其他用途。使用者需自行确认其对资源的使用符合北京大学的有关规定及适用法律法规。

The Typst template source code is licensed under the MIT License.

The Peking University emblem logo (assets/pkulogo.pdf) and name wordmark (assets/pkuword.pdf) files bundled with this template are taken from the pkuthss package on CTAN. They are trademarked and copyrighted assets, excluded from the MIT license, and remain the property of their respective owners. They may be used only for academic, non-commercial purposes such as thesis formatting. Unless otherwise permitted by law or authorized by the rights holders, these assets must not be redistributed, modified, or used for any other purpose. Users are responsible for ensuring that their use of these assets complies with the relevant policies of Peking University and applicable laws and regulations.