告别格式噩梦：用Typst构建可编程、自动化的现代化简历-洪萨配资

1. 项目概述：为什么我们需要一个现代化的简历构建方案？

在求职或职业发展的关键节点，一份简历就是你的“数字名片”。然而，制作简历的过程，对许多人来说，却是一场与格式、排版、兼容性持续斗争的噩梦。你是否经历过这样的场景：精心在Word或在线编辑器里调整好格式，一换台电脑打开，字体变了，布局乱了，页边距也跑偏了；想微调一下某个模块的位置，却牵一发而动全身，整个文档的排版都崩了；或者，当你需要针对不同岗位投递不同版本的简历时，不得不维护多个文件，任何一个内容的更新都意味着重复劳动。这些痛点，正是传统简历制作工具难以解决的顽疾。

kiwamizamurai/resume-typst这个项目，正是为了解决这些问题而生的一个优雅方案。它不是一个简单的模板，而是一个基于Typst排版系统的、高度可编程的简历构建框架。Typst 是什么？你可以把它理解为 LaTeX 的现代化、更易上手的继任者，或者一个专门为学术和技术文档设计的“代码式”排版语言。这个项目的核心价值在于，它将简历内容（你的经历、技能、教育背景）与简历的视觉呈现（排版、样式、颜色）彻底分离。你只需要在一个结构化的文本文件（比如 YAML 或 TOML）中填写你的个人信息，然后通过 Typst 的模板引擎，一键生成格式完美、风格统一、且支持 PDF、HTML 等多种输出格式的简历。

对于开发者、设计师、研究人员等对文档质量和自动化有要求的专业人士来说，这简直是福音。它意味着版本控制（用 Git 管理简历的每一次修改）、批量生成（为 A 公司生成强调项目经验的版本，为 B 公司生成强调学术成果的版本）、以及绝对的格式稳定性。无论你在 Windows、macOS 还是 Linux 上，无论用哪个 PDF 阅读器打开，你的简历看起来都一模一样。接下来，我将深入拆解这个项目的设计思路、核心技术细节，并手把手带你从零开始，打造一份属于你自己的、可编程的现代化简历。

2. 核心设计哲学：内容与样式的彻底分离

2.1 传统方案的困境与Typst的破局

在深入代码之前，我们必须理解resume-typst项目背后的核心设计哲学：关注点分离。传统的 Word 或 Pages 文档，内容、格式、样式是混杂在一起的。你设置了一个段落的字体，这个信息就“粘”在了那段文字上。这种“所见即所得”的编辑方式，对于简单文档是直观的，但对于需要高度一致性和频繁更新的简历来说，就成了维护的噩梦。

Typst 采用了完全不同的范式。它像编程一样处理文档：你编写的是“源代码”（.typ 文件），其中通过标记和函数调用来描述文档的结构和内容；然后，Typst 编译器（一个命令行工具）会“执行”你的源代码，生成最终的 PDF 文档。这带来了几个革命性的优势：

可重复性：同样的源代码，在任何机器、任何时间编译，都会得到完全相同的输出。彻底解决了“在我电脑上好好的”这类问题。
可维护性：样式被定义在集中的位置（通常是函数或变量）。如果你想改变所有章节标题的颜色，只需修改一行代码，所有标题会自动更新。
可版本控制：.typ 文件是纯文本，可以完美地用 Git 进行版本管理。你可以清晰地看到简历的每一次修改历史，甚至可以创建不同的分支来尝试不同的设计风格。
可编程性：你可以使用条件判断、循环、变量等编程概念。例如，轻松实现“如果技能熟练度大于 7 颗星，则用粗体显示”这样的动态效果。

resume-typst项目将这一哲学发挥到了极致。它通常包含以下几个核心部分：

数据文件：一个data.yml或resume.toml文件，以结构化的方式存储你所有的简历信息（姓名、联系方式、工作经历、项目等）。这就是“内容”。
模板文件：一个或多个.typ文件，定义了简历的布局、样式、以及如何从数据文件中读取并渲染每一项信息。这就是“样式”和“逻辑”。
构建脚本：一个简单的脚本（如compile.sh或Makefile），用于执行编译命令，将数据与模板结合，生成最终的 PDF。

这种分离让你可以像管理代码一样管理你的简历。更新工作经历？只需编辑data.yml文件。对排版不满意？调整模板文件中的样式函数。想尝试极简风格或学术风格？甚至可以切换不同的模板文件，而你的核心数据无需改动。

2.2 项目结构深度解析

一个典型的resume-typst项目目录结构可能如下所示：

my-resume/ ├── resume.toml # 核心：你的简历数据内容 ├── template.typ # 核心：简历排版模板 ├── theme.typ # 可选的：样式主题定义（颜色、字体等） ├── Makefile # 构建自动化脚本 ├── output/ │ └── resume.pdf # 编译生成的PDF文件 └── README.md # 项目说明文档

让我们逐一拆解每个文件的核心作用：

resume.toml(数据层)：这是项目的“数据库”。TOML 是一种比 YAML 更简洁、对格式要求更严格的配置文件格式，非常适合这种场景。它清晰地定义了数据的结构。例如：

[personal] name = "张三" email = "zhangsan@example.com" phone = "+86 13800138000" website = "https://zhangsan.dev" [[experience]] company = "某科技公司" position = "高级软件工程师" start_date = "2020-07" end_date = "至今" highlights = [ "主导了微服务架构重构，将系统响应时间降低了40%。", "设计和实现了核心交易风控模块，日均处理千万级请求。", "带领3人小组推行代码评审规范，将线上缺陷率降低了25%。" ] [[skills]] category = "编程语言" items = [ { name = "Python", level = 5 }, { name = "JavaScript", level = 4 }, { name = "Go", level = 3 } ]

这种结构化的数据，不仅人类可读，机器（Typst模板）更易解析。你可以轻松地添加、删除或修改任何条目。

template.typ(表现层与逻辑层)：这是项目的“大脑”。它使用 Typst 语法，包含以下关键部分：
1. 导入与配置：导入 Typst 标准库、自定义主题，并加载数据文件。
```
#import "@preview/resume:0.1.0": * #show: resume.with( title: "我的简历", data: yaml("resume.yaml"), // 或 toml("resume.toml") // 应用主题 theme: theme-modern, )
```
2. 布局函数：定义整个页面的布局，比如两栏（左侧联系信息+技能，右侧工作经历+教育）或单栏。Typst 的grid、stack、place等布局函数在这里大显身手。
3. 内容渲染函数：这是一系列自定义函数，负责将resume.toml中的每一类数据（如experience,education）渲染成美观的文档块。例如，一个render-experience函数会循环遍历所有工作经历，为每一项生成包含公司、职位、时间和要点列表的段落。
theme.typ(样式层)：为了进一步分离关注点，高级的模板会将视觉样式单独提取到一个主题文件中。这里定义了调色板、字体家族、字号、间距、图标集等所有视觉元素。
```
// theme.typ #let theme-modern = ( primary-color: rgb(0, 100, 200), secondary-color: rgb(100, 100, 100), font-body: ("Noto Sans SC", sans-serif), font-heading: ("Noto Serif SC", serif), spacing-small: 0.5em, spacing-medium: 1em, // ... 更多样式变量 )
```
通过切换主题文件，你可以在“专业蓝”、“学术灰”、“活力橙”等不同视觉风格间无缝切换，而无需触碰模板逻辑或数据。
Makefile(自动化层)：这是提升效率的关键。一个简单的 Makefile 可以让你用一句命令完成所有事情。
```
.PHONY: all clean watch all: output/resume.pdf output/resume.pdf: template.typ resume.toml theme.typ typst compile template.typ output/resume.pdf watch: typst watch template.typ output/resume.pdf clean: rm -f output/resume.pdf
```
执行make编译，make watch进入监听模式（文件保存后自动重新编译），make clean清理输出文件。这极大地简化了工作流。

实操心得：在项目初期，我建议你从克隆一个现有的、设计良好的resume-typst模板开始（比如项目作者提供的示例）。不要急于从头编写所有 Typst 代码。先理解其数据结构和模板的渲染逻辑，然后替换resume.toml中的内容为你自己的。在这个过程中，你会自然而然地学会如何修改样式。这比直接阅读 Typst 官方文档上手要快得多。

3. 从零开始：搭建你的第一个Typst简历

3.1 环境准备与工具链配置

工欲善其事，必先利其器。使用resume-typst的第一步是搭建本地开发环境。整个过程非常轻量，不依赖庞大的 IDE 或商业软件。

1. 安装 Typst 编译器Typst 的核心是一个独立的命令行工具。访问其官方网站，根据你的操作系统下载对应的安装包。对于 macOS 和 Linux 用户，使用包管理器通常更便捷：

# macOS (使用 Homebrew) brew install typst # Linux (部分发行版，或使用官方脚本) curl -fsSL https://raw.githubusercontent.com/typst/typst/main/install.sh | sh # Windows (使用 Scoop 或直接下载 .msi 安装包) scoop install typst

安装完成后，在终端运行typst --version，确认安装成功。Typst 编译器非常小巧，启动迅速，这是它相对于 LaTeX 的巨大优势之一。

2. 选择并获取模板你不需要从零开始。GitHub 上有大量高质量的resume-typst模板。kiwamizamurai/resume-typst本身就是一个优秀的起点。打开终端，克隆该项目：

git clone https://github.com/kiwamizamurai/resume-typst.git my-resume cd my-resume

现在，你的my-resume目录里就拥有了一个完整的、可工作的简历项目骨架。花几分钟时间浏览一下目录结构，重点查看resume.toml（或resume.yaml）和template.typ文件，感受一下数据和模板是如何组织的。

3. 准备文本编辑器任何能编辑纯文本的编辑器都可以，但为了获得更好的体验（如语法高亮、实时预览），推荐使用 VS Code 并安装Typst 官方扩展。这个扩展提供了语法高亮、错误提示、代码补全，甚至集成编译和预览功能，能极大提升开发效率。

4. 安装中文字体（关键步骤）Typst 默认可能不包含中文字体。如果你的简历包含中文，必须确保系统有合适的中文字体，并在模板中正确引用。推荐使用开源字体，如思源黑体 (Source Han Sans)或思源宋体 (Source Han Serif)，它们风格现代，字重齐全，且完全免费可商用。

下载字体：从 GitHub 或 Adobe 官网下载思源字体的 OTF/TTF 文件。
引用字体：在模板文件（如template.typ或theme.typ）的开头，使用#show规则或#set text命令来设置字体。你需要指定字体文件的完整系统路径。
```
// 在 template.typ 顶部附近添加 #set text( font: ("Source Han Sans SC", "Noto Sans SC", sans-serif), lang: "zh", )
```
这里"Source Han Sans SC"是首选字体，如果系统未找到，会尝试"Noto Sans SC"，最后回退到任何无衬线字体。lang: "zh"告诉 Typst 文档的主要语言是中文，这会影响断行和标点挤压等排版细节。

注意事项：字体路径是新手最常见的坑。在 Windows 上，路径可能是"C:/Windows/Fonts/simhei.ttf"；在 macOS 上，可能是"/Library/Fonts/Arial Unicode.ttf"。一个更健壮的方法是，将字体文件放在项目目录下的fonts/文件夹中，然后使用相对路径引用，如font: ("./fonts/SourceHanSansSC-Regular.otf", ...)，这样可以确保项目在任何机器上编译时都能找到字体。

3.2 数据层：结构化你的简历内容

现在，打开项目中的resume.toml文件。这是你投入时间最多的地方，因为内容才是简历的灵魂。模板通常已经定义好了清晰的数据结构，你只需要像填空一样填写自己的信息。

核心数据结构解析：

一个完整的简历数据文件通常包含以下顶级部分：

部分	TOML 键名示例	描述与填写要点
个人信息	`[personal]`	姓名、职位、邮箱、电话、个人网站/博客、GitHub/LinkedIn 链接。确保联系方式准确专业。
工作经历	`[[experience]]`	使用双括号`[[...]]`表示这是一个数组（列表）。每个经历是一个表，包含公司、职位、起止时间、地点和成就要点 (`highlights`)。成就要点要用动词开头，量化结果，如“优化了数据库查询，将API 响应速度提升了 50%”。
教育背景	`[[education]]`	学校、专业、学位、时间、GPA（如优秀可写）、相关课程或荣誉。
技能专长	`[skills]`或`[[skills]]`	可以按类别组织。建议使用分级（如 1-5 星）或熟练度标签（“精通”、“熟悉”、“了解”）。避免罗列，要体现与目标岗位的相关性。
项目经历	`[[projects]]`	对于开发者尤其重要。包括项目名称、你的角色、技术栈、项目简介和你的核心贡献。最好能提供可公开访问的代码仓库链接。
其他	`[languages]`,`[certifications]`,`[publications]`	根据个人情况添加，如语言能力、专业认证、学术发表等。

填写示例与技巧：

# resume.toml 片段 [personal] name = "李四" title = "全栈开发工程师 | 云原生技术爱好者" email = "lisi@example.com" phone = "+86 13912345678" website = "https://lisi.blog" github = "github.com/lisi" location = "上海" [[experience]] company = "某云计算公司" position = "后端开发工程师" location = "北京" start_date = "2021-03" end_date = "2024-02" highlights = [ "使用 Go 重构了核心计费服务，处理日均超 1 亿次 API 调用，错误率降至 0.01% 以下。", "引入并落地了服务网格 (Istio)，实现了细粒度的流量管理和金丝雀发布，部署风险降低 70%。", "设计并开发了实时监控告警平台，将平均故障恢复时间 (MTTR) 从 2 小时缩短至 15 分钟。", "主导团队代码规范与 CI/CD 流程优化，推动单元测试覆盖率从 60% 提升至 85%。" ] [[skills]] category = "后端开发" items = [ { name = "Go", level = 5 }, { name = "Python", level = 4 }, { name = "Java", level = 3 } ] [[skills]] category = "云与基础设施" items = [ { name = "Docker & Kubernetes", level = 4 }, { name = "AWS / 阿里云", level = 4 }, { name = "Prometheus & Grafana", level = 3 } ]

关键点：

量化：尽可能使用数字来体现你的贡献和价值。
动词开头：用“设计”、“开发”、“优化”、“提升”、“降低”等强有力的动词开始每一个要点。
相关性优先：根据你投递的岗位，调整highlights和skills的强调重点。你可以维护多个resume-<岗位>.toml文件，共用同一个模板来生成针对性的简历。
保持简洁：一页纸简历是最佳长度。通过精炼语言和选择最重要的成就来控制内容量。

3.3 模板层：定制化你的视觉风格

在填写好数据后，你可能希望对模板的视觉效果进行一些调整，使其更符合你的个人品牌。这需要你稍微深入一下template.typ文件。

1. 修改基础样式找到模板中定义全局样式的地方，通常是文件开头附近的#set page(...)或#set text(...)命令。

调整页面边距：一页纸简历需要充分利用空间。可以适当减小边距。
```
#set page( margin: (top: 1.5cm, bottom: 1.5cm, left: 1.8cm, right: 1.8cm) )
```

调整行距与段距：让文字呼吸感更强。

#set par( leading: 1.2em, // 行距 spacing: 0.5em, // 段间距 )

2. 修改颜色主题颜色是建立视觉识别最快的方式。在theme.typ或模板的样式定义部分，找到颜色变量。

// 在 theme.typ 中修改 #let primary-color = rgb(0, 102, 204) // 深蓝色，专业稳重 #let secondary-color = rgb(128, 128, 128) // 灰色，用于次要信息 #let accent-color = rgb(220, 60, 50) // 红色，用于少量强调（如姓名、链接）

你可以使用在线配色工具（如 Coolors 或 Adobe Color）来生成和谐的配色方案，然后替换这里的 RGB 值。

3. 调整布局结构大多数简历模板采用两栏布局。栏宽比例可以通过修改grid函数的参数来调整。

// 在 template.typ 中找到布局部分 #let layout = grid( columns: (30%, 70%), // 将左侧栏宽度从默认的 35% 调整为 30%，给主要内容更多空间 gutter: 2em, // 栏间距 )[ // 左侧栏内容（个人信息、技能等） ... // 右侧栏内容（经历、教育等） ... ]

4. 自定义章节渲染如果你想改变“工作经历”这个部分的标题样式，或者调整每个经历条目内部的间距，你需要找到对应的渲染函数。例如，模板中可能有一个叫render-section或render-experience的函数。

// 找到并修改渲染章节标题的函数 #let render-section(title) = { block( fill: primary-color, // 标题背景色 inset: 0.5em, // 内边距 radius: 0.3em, // 圆角 text(size: 1.1em, weight: "bold", color: white)[#title] // 标题文字样式 ) v(0.8em) // 标题与内容之间的垂直间距 }

实操心得：修改模板时，遵循“小步快跑，频繁编译”的原则。每次只修改一个地方（比如只改一个颜色），然后立即运行typst compile template.typ output.pdf或make命令查看效果。Typst 的编译速度极快（通常小于1秒），这让你可以实时获得反馈，快速迭代设计。不要一次性修改太多地方，否则出了问题很难定位。

4. 高级技巧与自动化工作流

4.1 条件渲染与多版本生成

这是resume-typst作为“可编程简历”最强大的功能之一。你可以根据不同的求职目标，从同一份数据源生成不同侧重点的简历。

方案一：基于数据过滤在resume.toml中，可以为每个条目添加tags标签。

[[experience]] company = "某电商公司" position = "Java开发工程师" tags = ["backend", "java", "ecommerce"] highlights = [...] [[experience]] company = "某AI实验室" position = "算法实习生" tags = ["ai", "ml", "python", "research"] highlights = [...]

然后，在模板中，你可以编写逻辑，只渲染带有特定标签的经历。

#let filtered-experiences = data.experience.filter(exp => "backend" in exp.tags) #for exp in filtered-experiences { // 渲染这个经历 }

你可以创建多个模板文件，如template-backend.typ和template-ai.typ，分别过滤和渲染不同的经历集合。

方案二：基于外部变量更灵活的方式是通过命令行参数或环境变量来控制。Typst 支持从外部传入参数。

修改模板，接收一个target参数：

#let target = option("target", default: "general") // 从命令行读取 --target 参数

在编译时指定参数：

typst compile template.typ output/resume-backend.pdf --target=backend typst compile template.typ output/resume-ai.pdf --target=ai

在模板内部，根据target的值使用条件语句 (if) 来决定渲染哪些内容或应用哪种样式。

方案三：多数据文件最简单直接的方法，就是维护多个数据文件：resume-backend.toml,resume-ai.toml。然后通过构建脚本，用同一个模板编译它们。

# Makefile 示例 output/resume-backend.pdf: template.typ resume-backend.toml typst compile template.typ $@ output/resume-ai.pdf: template.typ resume-ai.toml typst compile template.typ $@ all: output/resume-backend.pdf output/resume-ai.pdf

运行make all即可一次性生成所有版本的简历。这种方法逻辑清晰，易于管理，推荐大多数用户使用。

4.2 集成CI/CD：实现简历的自动构建与部署

将你的简历项目放在 GitHub 或 GitLab 上，你可以配置持续集成/持续部署流水线，实现自动化构建和发布。这意味着，每次你更新resume.toml并推送到仓库，云端会自动编译生成最新的 PDF，并发布到某个可访问的 URL（比如 GitHub Pages），你永远可以分享一个最新的简历链接。

以 GitHub Actions 为例：

在项目根目录创建.github/workflows/build.yml文件。

编写工作流配置：

name: Build Resume PDF on: push: branches: [ main ] workflow_dispatch: # 允许手动触发 jobs: build: runs-on: ubuntu-latest steps: - name: Checkout code uses: actions/checkout@v4 - name: Setup Typst run: | curl -fsSL https://raw.githubusercontent.com/typst/typst/main/install.sh | sh echo "$HOME/.local/bin" >> $GITHUB_PATH - name: Compile Resume run: | typst compile template.typ resume.pdf - name: Upload PDF as artifact uses: actions/upload-artifact@v4 with: name: resume-pdf path: resume.pdf # 可选：部署到 GitHub Pages - name: Deploy to GitHub Pages uses: peaceiris/actions-gh-pages@v3 if: github.ref == 'refs/heads/main' with: github_token: ${{ secrets.GITHUB_TOKEN }} publish_dir: ./ publish_branch: gh-pages keep_files: true force_orphan: true

提交并推送这个工作流文件。之后，每次推送后，你都可以在 Actions 标签页看到构建状态，并下载生成的 PDF 工件。如果配置了 GitHub Pages，你的简历 PDF 将可以通过https://<你的用户名>.github.io/<仓库名>/resume.pdf这个固定链接访问。

4.3 扩展功能：生成HTML与JSON简历

虽然 PDF 是求职市场的标准格式，但在某些场景下（如个人网站、在线作品集），HTML 格式的简历更具交互性，而 JSON 格式则便于被机器解析（如导入招聘系统）。

Typst 主要输出 PDF，但我们可以利用其生态或结合其他工具来实现多格式输出。

生成 HTML：一种方法是使用typst的--format html实验性功能（如果可用）。更成熟的方法是，利用resume.toml这个结构化的数据源，使用其他模板引擎来生成 HTML。例如，你可以使用一个简单的 Python 脚本：

# generate_html.py import toml import jinja2 # 1. 加载数据 with open('resume.toml', 'r', encoding='utf-8') as f: data = toml.load(f) # 2. 加载 HTML 模板 env = jinja2.Environment(loader=jinja2.FileSystemLoader('.')) template = env.get_template('resume_template.html') # 3. 渲染并输出 html_output = template.render(**data) with open('output/resume.html', 'w', encoding='utf-8') as f: f.write(html_output) print("HTML resume generated!")

你需要编写一个对应的resume_template.html文件，使用 Jinja2 语法来循环遍历data['experience']等数据。这样，你就拥有了 PDF 和 HTML 两套输出。

生成 JSON：这更简单，因为resume.toml本身几乎就是结构化的数据。你可以直接用工具转换，或者写几行脚本：

# 使用 yq (处理 YAML/TOML/JSON 的命令行工具) yq -o=json resume.toml > resume.json

生成的resume.json可以用于构建个人网站的 API，或者导入到支持 JSON 的在线简历管理平台。

5. 常见问题与排查技巧实录

在实际使用resume-typst的过程中，你可能会遇到一些典型问题。以下是我在多次使用中总结的排查清单和解决方案。

5.1 编译与渲染问题

问题现象	可能原因	解决方案
编译错误：`Unknown field`	数据文件（TOML/YAML）中的字段名与模板中引用的字段名不匹配。	仔细检查模板中`data.experience`、`data.skills`等路径，确保与数据文件中的键名完全一致（包括大小写）。使用`typst watch`命令，它会在控制台给出更详细的错误位置。
中文显示为方框或乱码	1. 系统未安装模板中指定的中文字体。 2. 字体名称拼写错误。 3. 未设置文档语言。	1. 确认字体已安装，或在模板中使用完整文件路径引用字体文件。 2. 检查字体家族名称。在 macOS 的“字体册”或 Windows 的字体设置中查看字体的确切名称。 3. 在`#set text(...)`中添加`lang: "zh"`。
布局错乱，内容溢出页面	1. 内容过多，超过一页。 2. 边距设置过小。 3. 某个元素（如图片）尺寸过大。	1. 精炼简历内容，删除不重要的条目。可以尝试调小全局字号（如`#set text(size: 10pt)`）。 2. 适当增加`page(margin: ...)`。 3. 检查是否有自定义的元素没有正确设置大小，使用`scale`或`width`限制其尺寸。
生成的PDF链接无法点击	Typst 默认生成的 PDF 链接是可点击的，但某些阅读器或打印设置可能禁用此功能。	确保在模板中，链接使用`#link`函数生成。对于电子版简历，建议在生成后使用 Adobe Acrobat 或预览工具检查链接是否有效。对于打印，链接无关紧要。
列表符号或图标不显示	使用了自定义图标字体（如 FontAwesome），但未正确嵌入或路径错误。	如果模板依赖图标字体，请确保字体文件在项目中，并且路径正确。考虑使用更简单的替代方案，如 Unicode 符号（✓, ●, »）或直接省略图标，保持简洁。

5.2 内容与设计优化建议

一页纸原则：对于绝大多数行业和资历（除非是资深学者或高管），一页纸简历是最佳选择。如果内容溢出：
- 删减：移除超过5年的旧经历、无关的技能、过于基础的课程。
- 浓缩：合并类似的职责，使用更精炼的语言。每个成就要点尽量控制在1-2行。
- 调整样式：微调字号（不小于10pt）、行距、段距、页边距。两栏布局比单栏更能利用空间。
量化与动词：反复检查你的highlights。将“负责系统优化”改为“主导了订单系统的数据库索引优化，使查询延迟从200ms降低到20ms”。数字和强有力的动词能让你的成就更具冲击力。
保持一致性：
- 日期格式：全程使用 “YYYY-MM” 或 “MM/YYYY” 格式，不要混用。
- 标点符号：中文内容使用全角标点，英文内容使用半角标点。句尾统一加句号或不加。
- 术语大小写：技术名词如 “JavaScript”, “Kubernetes” 保持正确的大小写。
针对不同岗位定制：不要用同一份简历海投。针对心仪的岗位，仔细阅读职位描述（JD），提取关键词，然后调整你的resume.toml：
- 将最相关的经历和技能提到更靠前的位置。
- 在成就要点中，使用 JD 里出现的术语（如“微服务”、“敏捷开发”、“用户增长”）。
- 可以适当调整personal.title来匹配目标职位。

5.3 版本控制与协作最佳实践

将简历作为代码管理，带来了巨大的便利，但也需要遵循一些最佳实践：

提交信息规范化：每次修改后，使用清晰的提交信息。例如：

git commit -m “feat(experience): 添加XX公司后端工程师经历” git commit -m “style(theme): 将主色调调整为深蓝色” git commit -m “fix(typo): 修正电话号码错误”

分支策略：可以创建一个dev分支进行日常修改和样式实验，main分支始终保持为可随时编译出“正式版”简历的状态。为不同的求职方向创建特性分支，如feature/backend-resume。
.gitignore：确保将输出目录（如output/）和临时文件添加到.gitignore中，避免将生成的 PDF 纳入版本控制。
```
# .gitignore output/ *.pdf
```
数据备份：你的resume.toml是核心资产。除了本地 Git 仓库，定期将其备份到云端其他位置（如加密的云存储）是明智之举。

我个人在实际使用kiwamizamurai/resume-typst及其类似方案超过一年后，最大的体会是它彻底将我从格式调整的苦役中解放了出来。现在，更新简历变成了一件愉悦的事情：我只需要专注地更新resume.toml里的文字内容，然后运行一条命令，一份格式完美、随时可用的最新版简历就生成了。这种“内容即代码”的思维，不仅适用于简历，也可以扩展到任何需要高质量、可重复生成文档的场景。如果你还在为简历排版烦恼，强烈建议花一个下午的时间尝试一下这个工作流，这可能是对你职业发展效率最高的一次投资。