免安装本地环境！用Typst Web编辑器在线使用modern-cv制作简历的完整指南
免安装本地环境！用Typst Web编辑器在线使用modern-cv制作简历的完整指南
modern-cv 是一款使用 Typst 编写的现代简历模板，灵感来自经典的 Awesome-CV LaTeX 模板。借助 Typst Web 编辑器，你完全不需要在本地安装任何编译环境——打开浏览器就能在线编辑、实时预览，并一键导出排版精美的简历 PDF。本指南带你从零开始，走通"上传模板 → 填写信息 → 在线导出"的完整流程。
💡 为什么选择 Typst Web 编辑器
对于新手和普通用户来说，本地搭建排版环境往往劝退感满满。而 Typst Web 编辑器把一切搬进了浏览器：
| 对比项 | 本地环境 | Typst Web 编辑器 |
|---|---|---|
| 安装 Typst CLI | 需要 | ❌ 不需要 |
| 安装 Roboto / Source Sans 3 字体 | 需要 | ✅ 已内置，无需额外操作 |
| 实时预览效果 | 需手动编译 | ✅ 边写边看 |
| 导出 PDF | 命令行执行 typst compile |
浏览器内直接下载 |
也就是说，免安装、零配置是这套方案最大的卖点，非常适合只想快速做出一份简历、不想折腾命令行工具的朋友。
📋 开始前的两点准备
根据 README.md 的说明，使用 Web 编辑器时字体方面几乎没有负担：
- 正文与标题字体：模板依赖
Roboto和Source Sans 3两款字体，Typst Web 应用已内置，无需任何额外操作。 - 联系信息图标：模板通过 FontAwesome 图标包显示邮箱、电话、GitHub 等小图标。由于这些图标字体不在浏览器内置列表中，需要把 Font Awesome 下载包中的
otf字体文件上传到项目的fonts文件夹中，编辑器即可自动识别。
⚠️ 如果你看到简历上的小图标显示为空白或问号，90% 的情况是漏传了
fonts文件夹。
🚀 三步在线打开 modern-cv 模板
第一步：在 Web 编辑器中创建项目
打开 Typst 官方 Web 应用，新建一个空白项目即可，不需要任何初始化命令。
第二步：上传模板文件
把仓库中这几部分文件上传到项目里（可打包后批量拖入）：
- 模板入口：template/resume.typ
- 各分区示例：template/sections/education.typ、template/sections/experience.typ、template/sections/skills.typ、template/sections/projects.typ
- 模板素材：
template/assets/下的头像、签名图片 - 模板核心库：lib.typ
- 前面提到的 Font Awesome
otf字体文件（放入fonts/文件夹）
上传完成后，只需把 template/resume.typ 第一行的包引用改为指向你上传的本地文件：
#import "./lib.typ": *
这样编辑器就会使用你本地的模板代码，而不是在线包，改什么立刻看到什么。
第三步：编译导出 PDF
保存后编辑器会自动编译，在预览面板确认效果无误，即可直接下载 PDF 简历，全程不接触任何命令行。
✏️ 自定义你的简历内容
打开 resume.typ，顶部 resume.with(...) 区域就是整个简历的"控制中心"，参考 template/resume.typ：
- 个人信息：姓名、邮箱、电话、主页、GitHub 等联系方式，改字符串即可
- 职位头衔：
positions列表控制姓名下方的角色描述 - 头像：
profile-picture指向assets/profile.png，换成自己的照片就完成"换脸" - 纸张与语言：
paper-size切换 A4 / us-letter，language参数可切换本地化文本，做中文简历时尤其有用
下面的 #include 行则负责引入教育背景、工作经验、技能、项目四个分区，每个分区对应 template/sections/ 下的独立文件，增删分区就像增删积木一样简单。
💼 顺手再做一封求职信
做完简历别急着收工——同一套模板还内置了求职信（Cover Letter）。把 template/coverletter.typ 或 template/coverletter2.typ 也上传进来，改一改正文就能在线生成风格统一的求职信，和简历一起投递，专业感直接拉满。
🛠️ 遇到问题的自助资料
- 模板 API 手册源码：docs/manual.typ
- 模板核心实现（了解每个参数的作用）：lib.typ
- 各场景渲染效果对照图：tests/ 目录下每个用例都附带了参考截图
- 版本与打包信息：typst.toml
❓ 常见问题速查
Q：编译报错找不到字体？
检查 Roboto、Source Sans 3 是否来自 Web 应用内置字体，以及 fonts 文件夹是否传入了 Font Awesome 的 otf 文件。
Q：图标位置是空白框？
同样是图标字体问题，按上文第二步补齐 fonts 文件夹后重新保存即可。
Q：想改主题色、页边距怎么办？
全部集中在 resume.typ 顶部的 resume.with(...) 参数区（如 colored-headers、show-footer），改完即时预览，无需记命令。
Q：在线做的简历能换设备继续编辑吗？
可以。项目文件（.typ 源码 + 图片 + 字体文件夹）保存在编辑器云端，任何设备打开 Typst Web 应用继续编辑即可。
🎉 到这里，一份免安装、零环境的 modern-cv 在线简历就制作完成了。把这套流程存下来，下次换工作、投递实习，只需 10 分钟就能产出一份排版专业的 PDF 简历。