Reactive-Resume 导出功能实操指南：3 步导出 PDF，再用 JSON 给简历做个备份
【免费下载链接】reactive-resumeA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!项目地址: https://gitcode.com/GitHub_Trending/re/reactive-resume
Reactive-Resume 是一款开源的在线简历构建工具，编辑完成后可以把成果带出系统。它支持 PDF、DOCX、Markdown、JSON 四种导出格式，其中 PDF 用于投递，JSON 用于备份和迁移。读完本文，你能独立完成一次 PDF 简历导出，并把整份简历备份成本地文件。
功能总览：PDF 和 JSON 各管什么
两种主力格式的定位差别很大，先对照这张表决定重点看哪部分：
| 格式 | 解决什么问题 | 适合谁 |
|---|---|---|
| 固定版式、保留模板排版，交给招聘方或 ATS 系统解析 | 投递岗位、邮件发给 HR、公开分享页面 | |
| JSON | 保留简历的全部原始数据和设置，可再导入 | 做简历备份、换设备迁移、接入其他工具 |
简单说：PDF 是"给面试官看的成品"，JSON 是"给自己留的底稿"。
3 步拿到 PDF 简历
第 1 步：打开导出入口。在 Dashboard 打开你的简历进入编辑器，点击顶栏右侧的 Download 按钮；右侧边栏的 Export 区块里也有同一个入口，组件代码在 apps/web/src/routes/builder/$resumeId/-sidebar/right/sections/export.tsx。
第 2 步：选择目标与格式。弹窗顶部用标签页选择导出 Resume 还是 Cover letter（只有包含求职信时才显示），然后点 PDF 下的 Download。生成期间按钮会显示加载状态并禁用，防止重复提交。
第 3 步：等待文件落盘。浏览器会以简历名称作为文件名自动保存，不需要手动选择目录。
背后发生的事可以压缩成两句：前端把简历 ID 和临时令牌发给服务端，服务端的 PDF 下载接口现场按你当前的模板与数据生成文件并回传，生成逻辑在 apps/server/src/http/resume-pdf.ts 的handleResumePdfDownload里。
导出前调好页面设置
PDF 长什么样，取决于导出时的页面设置。右侧边栏的 Layout / Page 区块可以调整：
- 纸张格式：A4、Letter 等不同尺寸，不同国家投递习惯不同；
- 页边距：水平、垂直边距都以点数（pt）为单位，数值越小内容越满；
- 语言区域：影响日期等内容的本地化呈现。
这些设置不是临时的，它们直接写进简历数据本身。字段的定义在 packages/schema/src/resume/data.ts，其中marginX、marginY就是水平与垂直边距的字段。所以无论导出几次、在哪个设备导入，页面设置都会跟着简历一起走。
如果内容跨页断得不好，还可以在 Layout 区块里拖拽区块到指定页，控制分页位置。
用 JSON 导出备份，用导入找回
JSON 导出的是简历的完整结构化数据，包括各区块内容和全部设置，围绕它可以做三件事：
- 备份同步：定期导出 JSON 存到网盘，即使账号数据出问题也能完整恢复；
- 跨设备迁移：在新环境的 Dashboard 导入 JSON，就能在当前账号下重建一份一模一样的简历；
- 第三方集成：把 JSON 放进 Git 做版本管理，或导出后让 AI 助手按岗位 JD 改写字段，改完再导入成一份新简历（导入前请人工核对 AI 的改动）。
导入入口在 Dashboard 的简历卡片区，对应组件是 apps/web/src/routes/dashboard/resumes/-components/cards/import-card.tsx，解析逻辑集中在 packages/import/src/ 目录，支持三种来源：
- Reactive Resume 原生 JSON 格式；
- 通用的 JSON Resume 标准格式；
- 从网页复制的 HTML 简历。
导出 JSON 的动作和 PDF 一样，就在下载对话框里选 JSON 格式，得到的文件就是一个包含全部简历字段的.json文本，可以直接阅读。
让导出更快更稳
- 压缩头像图片：图片过大是拖慢整体加载和预览的主要原因，上传前压到几百 KB 以内即可；
- 少用繁复的自定义样式：额外的字体和复杂排版会增加渲染开销，模板自带样式通常足够；
- 控制单份简历体量：经历过长的简历可以拆成"通用版 + 岗位定制版"，分别维护；
- 失败就重试：PDF 是现场生成的，偶发失败时回到下载对话框再点一次即可；令牌过期或状态异常时，接口会返回明确的错误提示，而不是给出半截文件。
常见问题速查
PDF 里版式错乱、内容被截断？通常是内容超出当前页边距或分页不合适。先在 Layout 区块把关键区块手动挪到对应页，再缩小边距试试，然后重新导出。
JSON 导入失败？一般是文件不是支持的格式，或内容被截断。确认文件来自 Reactive Resume 的 JSON 导出、扩展名是.json、内容是完整 JSON 后再导入。
导出的 PDF 能被 ATS 系统读吗？可以。PDF 由模板直接渲染，文字是可选择的文本而非图片，主流 ATS 能正常解析姓名、联系方式和经历字段。
导出的 DOCX 和 PDF 长得不一样？DOCX 是为了方便二次编辑，排版保真度不如 PDF，视觉上以 PDF 为准；需要精确呈现时投递 PDF。
小结
把 Reactive-Resume 的导出记住两句话就够了：投出去用 PDF，留下来用 JSON。页面设置存在简历数据里，导出多少次版式都不变；JSON 备份配合导入，让简历可以随时重建。想进一步定制，可以从 packages/schema/src/resume/ 目录读起，那里定义了简历每一块数据的结构。现在就打开你的简历，把一份 PDF 和一份 JSON 都导出来存好。
【免费下载链接】reactive-resumeA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!项目地址: https://gitcode.com/GitHub_Trending/re/reactive-resume
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
