1. 项目概述用Typst高效制作专业简历最近在帮朋友整理求职材料也顺带回顾了一下自己的简历。我发现一个挺有意思的现象很多技术背景的朋友简历内容本身很扎实但最终的排版和呈现效果却总差那么点意思。要么是Word调格式调到崩溃要么是LaTeX写起来太“重”要么就是用在线工具导出的PDF格式不统一。我自己也经历过这个阶段直到我开始用Typst来写简历整个体验才变得顺畅起来。Typst是一个新兴的、专门为科技文档设计的排版系统。它有点像LaTeX的现代化、轻量化版本语法更简洁编译速度飞快而且对中文等非拉丁语系文字的支持也相当不错。这个项目kiwamizamurai/resume-typst就是一个基于Typst的简历模板它提供了日式风格的履历书和职历书也就是我们常说的简历和详细的工作经历描述的生成方案。对于正在求职尤其是关注细节、希望简历在格式上也能体现专业性的开发者或工程师来说这是一个非常值得研究的工具。简单来说这个项目能帮你用代码Typst脚本来定义简历的样式和内容然后一键生成格式精美、排版一致的PDF文件。你不再需要手动拖动文本框、调整行距所有样式都通过代码控制修改起来既快又准还能用Git进行版本管理非常适合需要频繁更新简历的求职者。接下来我会详细拆解这个项目的使用、定制方法并分享一些在制作技术简历时的实操心得。2. 核心思路与工具选型解析2.1 为什么选择Typst而不是Word或LaTeX在决定使用任何工具前搞清楚“为什么”是关键。对于简历制作我们通常有几个选择Microsoft Word/Google Docs、LaTeX、HTML/CSS以及像Typst这样的新兴工具。Word/Google Docs的痛点在于可控性差。看似“所见即所得”但一旦内容稍多格式就容易“跑飞”。调整一个段落的间距可能引发连锁反应跨设备编辑时字体缺失、版式错乱更是家常便饭。最重要的是它无法进行版本控制你很难清晰地回溯“上个月投A公司时我改了什么描述”。LaTeX是学术界的标准排版能力强大生成的PDF极其专业。但它的学习曲线陡峭环境配置复杂编译速度慢尤其是涉及中文时而且语法对于只想写份简历的人来说过于冗长和底层。你常常需要引入一大堆宏包只为调整一个列表的样式。Typst的定位就很巧妙。它吸收了LaTeX在排版和内容分离上的精髓你用纯文本写内容用样式规则控制格式但语法设计得非常现代和友好。它内置了现代化的功能比如更智能的数学排版、对SVG和Emoji的原生支持以及毫秒级的编译速度。对于简历这种结构相对固定、但样式要求精致的文档Typst的优势非常明显你用简单的几行代码就能定义出漂亮的样式然后专注于内容本身。所有文件都是纯文本完美契合Git你可以为不同公司定制不同版本的简历轻松管理和对比。2.2 项目结构浅析简历Resume与职历书CV的区别这个模板项目提供了两个输出resume.pdf和cv.pdf。这对应了日式求职文档体系中常见的两种文件理解它们的区别对用好模板很重要。简历Resume / 履歴書通常是一到两页的摘要高度浓缩。它包含你的基本信息、联系方式、教育背景、工作经历只列公司、职位、时间、核心技能和关键成就。目的是让招聘者在10-30秒内对你有一个快速、清晰的印象。因此简历的排版需要极度清晰、易读重点突出留白合理。职历书CV / 職務経歴書则更为详细可能有多页。它会展开描述每一段工作经历中的具体职责、参与的项目细节、使用的技术栈、取得的量化成果以及个人贡献。它更像一份个人工作报告用于通过简历初筛后在面试环节供面试官深入参考。这个Typst模板分别提供了针对这两种文档的优化样式。resume模板偏向紧凑和高效的信息展示而cv模板则提供了更多的空间来描述细节和项目经历。在实际求职中通常需要同时准备这两种文档这个项目一次性解决了两个需求。2.3 核心依赖Typst与HackGen字体项目的依赖非常简单核心就两个Typst引擎和HackGen字体。Typst的安装与管理作者推荐通过mise来管理Typst。mise是一个跨平台的多版本运行时管理工具类似于asdf或nvm可以让你轻松安装和切换不同版本的Typst。这对于确保编译环境的一致性非常有用。当然你也可以直接从Typst官网下载安装包或使用包管理器如brew install typst安装全局版本。使用mise的好处是项目目录下会有一个.tool-versions文件锁定特定的Typst版本任何克隆你项目的人都能获得完全一致的编译环境避免了“在我机器上好好的”这类问题。字体的选择——HackGen这是一个非常明智的选择。HackGen是日本开发者将等宽字体“Hack”与日文字体“源柔ゴシック”GenRyu Gothic合并而成的字体家族。它的特点是等宽与比例字体的和谐英文部分基于Hack是优秀的编程等宽字体清晰易读中文部分基于源柔ゴシック是一款现代、优雅的黑体。中西文混排效果出色由于是专门合并设计的中英文之间的字重、基线对齐都非常协调避免了混合使用不同字体时常见的“高低不齐”、“粗细不一”的问题。包含Nerd Font符号项目也安装了font-hackgen-nerd这意味着你可以在简历中直接使用那些漂亮的开发图标比如Git、Docker、Kubernetes、各种编程语言的Logo让你的技能列表更加直观和专业。对于技术简历来说这是一个巨大的加分项。注意如果你主要面向国内企业求职需要确认HackGen字体中文字符集的完整性。对于绝大多数常用汉字它没有问题。但如果涉及非常生僻的字或者你希望使用其他中文字体如思源黑体、霞鹜文楷在Typst中更换字体也是非常容易的后续在定制章节会讲到。3. 环境配置与初体验3.1 一步步搭建你的Typst简历环境让我们从零开始把这个项目跑起来。假设你使用的是macOS系统Linux和WSL2下的操作也基本类似。第一步安装mise可选但推荐如果你还没有安装mise可以通过以下命令安装curl https://mise.jdx.dev/install.sh | sh安装完成后重启你的终端或者运行source ~/.bashrc(或~/.zshrc) 来加载mise。第二步克隆项目模板找一个你存放代码的目录执行git clone https://github.com/kiwamizamurai/resume-typst.git cd resume-typst这样你就得到了项目的所有源文件。第三步安装项目指定的Typst版本进入项目目录后mise会自动读取.tool-versions文件。你可以直接运行以下命令来安装文件中指定的Typst版本mise install或者你也可以手动安装Typst。如果不想用mise可以去Typst官网下载对应系统的二进制文件或者用Homebrew安装brew install typst。确保typst --version命令可以执行。第四步安装HackGen字体根据项目说明使用Homebrew安装brew install --cask font-hackgen font-hackgen-nerd对于Windows用户可以去HackGen的GitHub Release页面下载.ttf文件然后直接安装。Linux用户同样可以下载字体文件复制到~/.local/share/fonts/目录下然后运行fc-cache -fv刷新字体缓存。第五步首次编译生成PDF环境就绪后编译就非常简单了。项目在package.toml中定义了几个脚本mise run cv: 生成详细的职历书CVmise run resume: 生成简洁的简历Resumemise run build: 同时生成两者直接在项目根目录下运行mise run build如果一切顺利你会在resume和cv两个子目录下看到新生成的resume.pdf和cv.pdf。用你的PDF阅读器打开它们就能看到模板的默认效果了。3.2 理解项目目录结构与核心文件成功编译后我们来看看项目的骨架这是后续进行自定义的基础。resume-typst/ ├── cv/ │ ├── cv.pdf # 编译生成的职历书PDF │ └── main.typ # 职历书的主Typst文件 ├── resume/ │ ├── resume.pdf # 编译生成的简历PDF │ └── main.typ # 简历的主Typst文件 ├── assets/ # 可能存放图片、图标等资源 ├── components/ # 可复用的Typst组件如联系方式块、技能条 ├── lib.typ # 全局的样式、函数、颜色定义库 ├── package.toml # 项目元数据和脚本定义 ├── README.md └── .tool-versions # mise使用的版本锁定文件核心文件解读lib.typ这是整个项目的“样式大脑”。它定义了文档的全局样式比如页面大小、页边距、字体、颜色主题、标题样式、列表样式等。所有自定义的样式调整大部分都会在这里进行。components/目录这里存放着模块化的代码片段。例如可能有一个contact.typ文件里面定义了如何渲染姓名、电话、邮箱、GitHub链接的组件。这种设计极大地提高了代码的复用性和可维护性。你想修改联系方式在所有文档中的呈现方式只需要改这一个文件。resume/main.typ和cv/main.typ这是两个入口文件。它们通过#import语句引入lib.typ中的样式和components/中的组件然后组织具体的内容你的个人信息、经历等。你编辑简历内容主要就是修改这两个文件。package.tomlTypst的项目清单文件。它定义了项目名称、版本、入口文件以及最重要的——脚本。我们看到[script]部分定义了cv、resume、build这几个命令它们本质上是在调用typst compile命令并指定对应的入口文件。理解这个结构后你就会明白定制简历分为两个层面样式定制修改lib.typ和components/和内容填充修改resume/main.typ和cv/main.typ。4. 深度定制打造属于你的个人品牌简历直接使用模板生成的PDF只是开始。一份出色的简历必须打上你个人的烙印。下面我们从内容到样式一步步进行深度定制。4.1 内容填充用数据驱动你的简历首先打开resume/main.typ。你会看到文件内容是由Typst代码和你的信息混合组成的。Typst使用#符号来标识函数和指令。你需要找到类似下面的内容块进行修改// 示例结构非原文件精确内容 #let name 你的名字 #let title 求职意向例如高级后端工程师 #let contact components.contact( phone: 86 138-xxxx-xxxx, email: your.emailexample.com, github: your-github-id, location: 城市国家 ) #show: resume.with( name: name, title: title, contact: contact, education: [ // 教育经历数组 components.education( institution: 你的大学, degree: 学士/硕士, major: 专业, period: 2015.09 - 2019.06, details: 相关课程或荣誉GPA奖学金等 ), // ...可以添加多个教育经历 ], experience: [ // 工作经历数组 components.experience( company: 上一家公司, role: 职位, period: 2020.03 - 至今, location: 工作地点, details: [ // 工作职责和成就使用Markdown式的列表 [- 负责XX系统的架构设计与核心开发日处理请求量从10万提升至500万。] [- 引入Kafka消息队列解耦了A、B服务使系统延迟降低了40%。] [- 主导了团队代码规范的制定并通过CI/CD流水线进行自动化检查代码评审效率提升30%。] ] ), ], skills: components.skills( languages: [Go, Python, JavaScript], frameworks: [Gin, React, Kubernetes], tools: [Docker, Git, AWS EC2/S3, Prometheus] ) )内容填充的核心原则使用强动词和量化结果避免“负责”、“参与”这类模糊词汇。多用“设计”、“实现”、“优化”、“主导”、“将...提升了X%”、“减少了Y成本”。量化结果最具说服力。针对职位定制不要用一份简历海投。仔细阅读职位描述JD提取关键词并将你经历中与之匹配的部分调整顺序、强化描述。你可以利用Git分支功能为不同类型的职位如“后端开发”、“DevOps”、“技术负责人”创建不同版本的内容分支。技能列表要分层像示例中那样将技能分为“编程语言”、“框架/库”、“工具/平台”等类别显得更有条理。对于你精通的和熟悉的可以用不同方式标注比如在components.skills函数中设计一个熟练度参数。4.2 样式定制从颜色到布局的全面控制样式定制主要在lib.typ文件中。Typst的样式系统非常强大且直观。1. 修改颜色主题在lib.typ中通常会定义一些颜色变量例如// 定义颜色变量 #let primary-color rgb(#2e86ab) // 主色调可用于标题、分隔线 #let secondary-color rgb(#a23b72) // 辅助色可用于链接、高亮 #let text-color rgb(#333333) // 正文颜色 #let muted-color rgb(#666666) // 次要信息颜色你可以将这些十六进制颜色代码替换成任何你喜欢的颜色。推荐使用低调、专业的颜色如深蓝、深灰、墨绿等避免使用过于鲜艳刺眼的颜色。一个主色调贯穿始终能让简历看起来更统一、专业。2. 调整字体虽然HackGen很棒但你也可以更换。首先确保你的系统安装了目标字体然后在lib.typ中修改字体定义// 设置中英文分别使用的字体 #set text( font: (LXGW WenKai Screen, SimSun, serif), // 中文优先使用霞鹜文楷屏幕版回退到宋体 fallback: (HackGen, Microsoft YaHei, sans-serif) // 回退字体 )Typst的font参数可以接受一个数组它会按顺序尝试加载字体。这对于中英文混合排版非常有用可以为不同语言指定最合适的字体。3. 调整页面与段落样式// 设置页面例如A4纸页边距 #set page( paper: a4, margin: (top: 2.5cm, bottom: 2cm, left: 2.5cm, right: 2.5cm) ) // 设置标题样式 #show heading: set text(weight: bold, size: 1.3em) #show heading.where(level: 1): set block(above: 1.2em, below: 0.8em) // 一级标题的上下间距 // 设置列表样式 #show list: set list(marker: [—]) // 将默认的圆点改为破折号 #show list.item: set par(first-line-indent: 0pt) // 列表项首行不缩进通过这些设置你可以精细控制简历的每一处细节包括行距、段前段后间距、项目符号样式等。4. 创建或修改组件组件的魔力在于复用。假设你想在联系方式里增加一个个人博客的链接并且用一个特定的图标表示。 首先在components/目录下找到或创建contact.typ修改其函数定义增加blog参数// components/contact.typ #let contact(phone, email, github, location, blog) { // 使用Nerd Font图标 #set text(font: HackGen Nerd Font) #grid( columns: (1fr, 1fr, 1fr, 1fr, 1fr), // 调整为5列 gutter: 1em, [#icon(phone) #phone], [#icon(mail) #link(email)], [#icon(brand-github) #link(https://github.com/ github)], [#icon(map-pin) #location], [#icon(world) #link(blog)] // 新增博客项 ) }然后在resume/main.typ中调用这个组件时传入你的博客地址即可。这种方式使得添加、删除或重新排列联系信息变得非常简单。实操心得样式调整时建议一次只修改一个变量然后编译查看效果。Typst的编译速度极快通常不到1秒这让你可以像前端开发一样获得即时反馈极大地提升了定制效率。另外将你的自定义颜色、字体等也定义为变量并集中放在lib.typ文件的开头这样未来想要换一套主题色会非常方便。5. 高级技巧与自动化工作流5.1 利用Git进行简历版本管理这是使用代码编写简历的最大优势之一。你可以为简历创建一个Git仓库这个模板项目本身就是一个仓库。主分支main存放你最新、最通用的简历版本。功能分支当你想尝试一个全新的版式设计时可以创建一个feat/redesign分支大胆修改lib.typ而不用担心破坏主分支的稳定性。公司定制分支针对你心仪的公司A创建分支company-a根据其JD微调经历描述和技能关键词。针对公司B再创建分支company-b。提交信息使用有意义的提交信息如“feat: 添加AWS认证技能”、“fix: 修正项目时间描述”、“style: 调整主色调为深蓝色”。这样你的简历进化史一目了然。当你需要投递时切换到对应的分支编译生成PDF即可。这种管理方式是任何图形化工具都无法比拟的。5.2 集成CI/CD自动生成与部署你可以更进一步利用GitHub Actions或GitLab CI等持续集成服务实现“提交即发布”。每次你向GitHub推送修改CI会自动运行typst compile将生成的PDF作为构建产物Artifact提供下载甚至可以直接发布到你的个人网站。一个简单的GitHub Actions工作流示例.github/workflows/build.ymlname: Build Resume PDF on: [push] jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkoutv4 - name: Setup Typst uses: typst-community/setup-typstv2 with: version: latest - name: Install HackGen Font run: | wget -O hackgen.zip https://github.com/yuru7/HackGen/releases/download/v2.9.0/HackGen_v2.9.0.zip unzip -j hackgen.zip *.ttf -d ~/.local/share/fonts/ fc-cache -fv - name: Compile PDFs run: | typst compile resume/main.typ resume/resume.pdf typst compile cv/main.typ cv/cv.pdf - name: Upload PDFs as Artifact uses: actions/upload-artifactv4 with: name: generated-pdfs path: | resume/resume.pdf cv/cv.pdf这样你可以在任何地方通过浏览器访问GitHub仓库的Actions页面下载最新生成的简历无需本地环境。5.3 处理多语言简历如果你需要中英文双语简历有几种策略并行文件创建resume-zh.main.typ和resume-en.main.typ分别存放中英文内容但共享同一套lib.typ样式。这是最清晰的方式。条件编译在同一个文件中通过定义变量来控制显示哪种语言。#let lang en // 或 zh #let name if lang en { Your Name } else { 你的名字 } #let title if lang en { Software Engineer } else { 软件工程师 } // ... 其他所有文本都这样处理然后通过命令行参数或环境变量传递lang值给Typst脚本Typst支持从JSON文件读取数据这为实现该功能提供了可能。这种方式更高级但初始设置复杂一些。对于大多数情况我推荐第一种“并行文件”方案简单直接不易出错。6. 常见问题与排查技巧实录在实际使用中你可能会遇到一些问题。这里记录了一些常见的情况和解决方法。6.1 编译错误与排查问题1mise命令未找到或typst命令未找到。原因环境变量未正确配置。解决确保已按照安装步骤操作并重启了终端。对于mise可以运行mise activate或查看其安装后的提示。对于直接安装的Typst确认其安装路径已加入系统的PATH环境变量。问题2编译时报字体错误如Font ... not found。原因Typst在系统中找不到lib.typ中指定的字体。解决确认字体已正确安装。在macOS的“字体册”、Windows的“字体设置”中查看。对于Linux确保字体文件在~/.local/share/fonts/或/usr/share/fonts/目录下并运行了fc-cache -fv。在Typst文件中使用更通用的字体族名称如sans-serif,serif作为回退fallback。可以使用命令typst fonts来列出Typst可识别的所有系统字体确认你的字体在其中。问题3生成的PDF中文显示为方框或乱码。原因使用的字体不包含所需的中文字形。解决确保你指定的中文字体确实支持中文。将中文字体放在font数组的首位并提供一个可靠的回退字体列表。例如#set text(font: (Source Han Sans SC, Microsoft YaHei, sans-serif))。6.2 内容与样式优化中的“坑”问题4内容溢出页面或者最后一页只有一点点内容。原因内容长度控制不当。解决精简内容简历贵在精炼。反复审视每句话删除冗余词汇合并同类项。调整样式微调lib.typ中的page(margin: ...)适当减小页边距可以增加可用空间。或者调整#set par(line-spacing: ...)行距以及各级标题的above/below间距。使用分页控制Typst提供了#pagebreak()等指令但简历中应谨慎使用尽量通过内容裁剪来保持自然分页。问题5列表项描述过长导致排版不美观。解决遵循“STAR”原则情境、任务、行动、结果来组织描述使其简洁有力。在Typst中可以对列表项使用悬挂缩进让多行文本对齐。这通常在lib.typ的列表样式中定义。如果某一点成就特别突出可以考虑将其单独列出甚至加粗关键词。问题6如何插入公司Logo或个人头像解决Typst支持直接嵌入图片。#image(path/to/your/logo.png, width: 1.5cm)将图片文件建议使用PNG或SVG格式放在项目目录下如assets/然后在.typ文件中使用相对路径引用。注意控制图片尺寸避免喧宾夺主。6.3 求职季的实用技巧版本命名生成PDF时可以在文件名中加入版本信息或日期例如张三_后端工程师_简历_202405.pdf方便你和招聘方管理。ATS友好性许多大公司使用申请人跟踪系统ATS来初筛简历。确保你的PDF是纯文本可选的Typst生成的PDF默认就是避免使用过多花哨的排版和图形以免ATS解析失败。这个Typst模板生成的简历结构清晰通常是ATS友好的。打印测试在发送前务必用打印机打出一份纸质版看看效果。检查颜色在黑白打印下是否依然有足够的对比度页边距是否合适。文件大小Typst生成的PDF通常很小。但如果插入了高分辨率图片文件可能会变大。可以使用在线的PDF压缩工具进行优化确保邮件附件不会过大。从最初的克隆项目、安装环境到深度定制样式、填充个性化内容再到利用Git进行版本管理和CI自动化用Typst制作简历不仅仅是一个“生成PDF”的动作它更是一种将工程化思维应用于个人品牌塑造的实践。它迫使你更结构化地思考自己的经历和技能同时也给了你无限的自由度去呈现最好的自己。当你把简历的源文件也放进GitHub仓库它本身就成了你“注重工具链”、“追求自动化”、“拥有代码审美”这些软技能的一个小小证明。