使用 Typst /taɪpst/ 编写的非官方广东石油化工学院(Gdupt)毕业论文(设计)模板,能够简洁、快速、持续生成符合学校官方 Word 文档要求的毕业论文 PDF/SVG/PNG/HTML。
Important
非官方模板,存在不被学校认可的风险。
虽已尽力尝试复刻 Word 模板(通过叠层官方 Word 的 PDF 进行像素级微调),但因 Word 和 Typst 排版模型差异,还是可能存在页脚、标题间距等细微差异。
作者目前大一,不会 Word 也不会
Typst 是一个仍在活跃开发、可能会有较大变更的排版工具,请选择最新版模板与最新的 Typst 版本。
欢迎对 Typst 感兴趣的同学参与项目维护,提交 Issue 或 Pull Request,添加更多 features
若有 Typst 使用问题(或者想交流
- 符合学校规范:参考 官方 Word 文档 进行复刻,高度对齐学校格式要求
- 现代化排版:使用 Typst 现代排版系统,实时编译,语法简洁
- 实时预览:支持 VS Code 实时编辑、预览和双向跳转
- 完整功能:
- 封面
- 诚信承诺保证书
- 中英文摘要
- 目录
- 插图清单(必要时)
- 附表清单(必要时)
- 符号说明(必要时)
- 图表、公式、定理、算法、代码、列表等
- 参考文献
- 致谢
- 附录(必要时)
- 易于定制:格式文件简洁易读,可以根据需求调整样式
-
获取模板
# 克隆本仓库 git clone https://github.com/hibays/gdupt-thesis-typst.git cd gdupt-thesis-typst
-
安装 VS Code,选择把VS Code注册到右键菜单
-
安装 Tinymist Typst 扩展(没错!只需点点鼠标简简单单安装一个插件!)
-
用 VS Code 打开本文件夹,右键选择“在 VS Code 中打开”(即作为工作空间打开)
-
在 VS Code 中打开
thesis.typ文件 然后修改封面信息:#paper-cover( [毕业论文(设计)] // 大标题 [你的论文中文题目], // 中文题目 [Your English Title], // 英文题目 [你的学号], // 学号 [你的学院], // 学院 [你的专业], // 专业 [你的班级], // 班级 [你的姓名], // 学生 [指导教师姓名], // 指导教师 [指导教师职称], // 职称 datetime(year: 2025, month: 11, day: 12), // 启动日期 datetime(year: 2025, month: 12, day: 30), // 结束日期 显示下划线: true, 仅显示下划线: false, )
和摘要信息:
#paper-abstract( [ 这里是中文摘要内容。 ], [ 这里是英文摘要内容。 ], // 关键词 中文关键词: ([关键词1], [关键词2], [关键词3], [关键词4], [关键词5]), 英文关键词: ([kw1], [kw2], [kw3], [kw4], [kw5]), )
-
(可选)在
thesis.typ文件头部配置盲审模式和双面打印模式:// 启用盲审模式(用灰框替换个人信息) #show: mask-pass.with(enable: true) // 启用双面打印模式(自动加入空白页占位,支持自定义) #show: twoside-pass.with(enable: true)
-
按下 Tab 栏右上角的预览键即可打开实时预览
-
开始编辑,预览窗口会随键入实时更新,并可以双向跳转
-
安装 Typst
-
访问 Typst 官网 下载并安装
-
或使用包管理器安装:
# macOS (Homebrew) brew install typst # Windows (Scoop) scoop install typst # Linux curl -proto '=https' -tlsv1.2 -sSf https://raw.githubusercontent.com/typst/typst/main/install.sh | sh
-
-
编译论文
# 编译生成 thesis.pdf typst compile thesis.typ # 或使用 watch 模式(自动重新编译) typst watch thesis.typ
.
├── thesis.typ # 主论文文件(在此编写内容)
├── fmt-req.typ # 主格式要求和样式定义(更新时直接替换本文件)
├── refs.bib # 参考文献数据库(BibTeX 格式)
├── structure.typ # 论文Word模板复现文件
├── assets/ # 图片资源(校徽、题字等)
├── figures/ # 论文图表 xxx (有几个 example 图表)
├── extra/ # 额外模板如:任务书、选题表、开题报告等
└── docs/ # README 展示图片- ✅ 封面:符合学校规范的论文封面
- ✅ 诚信承诺书:自动生成的诚信承诺保证书
- ✅ 中英文摘要:支持中英文双语摘要
- ✅ 目录:自动生成的目录
- ✅ 插图清单(必要时):插图清单支持
- ✅ 附表清单(必要时):附表清单支持
- ✅ 符号说明(必要时):符号说明支持
- ✅ 页眉页脚:符合学校规范的奇偶页眉页脚
- ✅ 参考文献:支持 BibTeX 格式和文内引用,建议使用Zotero等文献管理软件
- ✅ 致谢:支持在盲审模式下自动删除致谢内容
- ✅ 附录(必要时):附录章节支持
- ✅ 表格:
tablex三线表环境,支持续表和脚注 - ✅ 图片:
imagex插图环境,支持子图和双语图题 - ✅ 公式:支持输入 Typst 公式或
$\LaTeX$ 公式(基于mitex) - ✅ 算法:算法环境,支持跨页续算法
- ✅ 代码:代码高亮显示
- ✅ 定理证明:定理和证明环境
- ✅ 化学方程式:支持使用 Typsium 编写化学方程式
- ✅ Graphviz 图:支持使用 diagraph 包绘制 Graphviz 图
- ✅ 盲审模式:支持盲审模式,用灰框遮蔽个人信息
- ✅ 双面打印:支持双面打印模式,可以得到和官方模板一样的打印样式
模板默认使用 Windows 系统字体。如需修改字体:
-
查看系统可用字体:
typst fonts
-
编辑
fmt-req.typ文件,修改字体配置:// 在文件开头找到字体定义 #let TimeSimSun = ("Times New Roman", "SimSun") // 宋体 #let TimeSimHei = ("Times New Roman", "SimHei") // 黑体 #let TimeFanSun = ("Times New Roman", "FangSong") // 仿宋_GB2312
See: 如何设置(中文)字体?和为什么代码块里面的中文字体显示不正常?
| 优先级 | 类型 | 项目 |
|---|---|---|
| MEDIUM | IMPL | 边框表格续表不正确 |
| LOW | THIEDPARTY | 导出为html时因equate包的实现问题导致公式被忽略,导致公式引用报错 |
| LOW | STYLE | 为了脚注不错位页码垂直高度相较Word模板偏矮 |
- Typst Universe - Typst 包和模板库
A: 完全可以!Typst 语法类似 Markdown,非常容易上手。你只需要按照模板中的示例填写内容即可。
A: 当然可以!通过 VS Code 和 Tinymist 扩展,你可以实时预览论文效果,鼠标点击预览窗口相应文字即可定位到 Typst 源码对应位置,无需任何环境配置。
A: Typst 编译速度极快,大纲跳转方便,无需像
A: 当然可以!不过最好借助Typst 语法作者技能这个 Skill,手动把他输入到 Prompt 或安装到 Claude Code/Codex/OpenCode 等智能体中,这样可以减少点语法错误。
A: 在 refs.bib 文件中添加 BibTeX 格式的参考文献,然后在正文中使用 @citation-key 引用。
A: 将图片放入 figures/ 目录,然后在正文中使用:
#imagex("figures/your-image.png", width: 80%)A: 确保系统中安装了所需的中文字体(宋体、黑体、Times New Roman),或修改 fmt-req.typ 中的字体配置。
PS: 如果你使用 WSL2,可以参考这里直接使用 Windows 宿主机字体:sudo ln -s /mnt/c/Windows/Fonts /usr/share/fonts/font && sudo fc-cache -fv
本模板基于以下优秀项目开发:
- 我油尖端的逐梦LAB老师兄 - 感谢师兄无私提供的各种毕业论文Word模板、参考范例和大量实践上的指导意见
- modern-sjtu-thesis - 大多数内容参考继承自上海交通大学 Typst 论文模板中的实现
- modern-nju-thesis - 南京大学 Typst 论文模板提供了gb7714-2015参考文献样式的修复实现
- Typst 中文社区 - 提供中文文档和疑难解答支持
- Typst 非官方中文交流群 - 感谢群佬的各种疑难解答
- BIT-Typst-Template - BIT 本科毕业设计(论文)模板
- 小红书上的毕业论文模板 - 提供毕业论文格式的参考(不建议看,和师兄提供的差别很大)



