企业官网建设流程全解析

从克隆到可投递：开源简历工具 Reactive Resume 上手实操全解

【免费下载链接】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，三步就能完成一份简历，基础使用甚至不需要注册账号；如果你希望数据完全归自己掌控，它还能用 Docker 自托管到你自己的机器或服务器上。这篇文章不按"排障清单"讲，而是带你走完一条"真实做出一份简历"的时间线：把服务跑起来 → 填内容 → 选模板 → 导出交付，判断和避坑的提示都揉在对应步骤里，跟着点就行。

🔌 最快把服务跑起来的方法

先克隆代码。我们只要最新版本，加个浅克隆参数，省下载历史：

git clone --depth=1 https://gitcode.com/GitHub_Trending/re/reactive-resume cd reactive-resume docker compose up -d

docker compose up -d之所以是核心命令，是因为仓库根目录的compose.yml已经把 PostgreSQL、Redis、SeaweedFS（S3 兼容对象存储）和应用本体串好，并且按依赖顺序健康检查通过后才拉起应用，你不需要一个个手敲容器。应用默认端口是 3000，起完在浏览器打开http://localhost:3000即可。

容易踩的坑有两个。其一，如果启动时报 "address already in use"，说明 3000 端口被占用了，调整你本地部署用的compose.yml（复制出来部署的那份，不是仓库里的源码）里reactive_resume服务的端口映射，并且把.env里的APP_URL同步改掉，否则应用会拿旧地址生成回调链接。其二，如果页面能打开但功能异常，可以先访问http://localhost:3000/api/health探活——这正是 compose 健康检查用的探测点；再不通就检查.env里的DATABASE_URL是否指向了容器网络内的 Postgres，完整环境变量说明在 docs/self-hosting/docker.mdx 里。

🧾 填入内容：一个让你不用动脑的编辑器

进入首页新建一份简历，你会落到构建器界面：左边是分区表单，右边是实时预览。打字时右侧简历同步刷新，没有"保存再预览"这一步——这也是项目名字里"Reactive"的含义。

建议按这个顺序填：基础信息（姓名、联系方式）→ 工作经历 → 教育背景 → 技能、项目等可选分区。先补基础信息的理由是，模板渲染和 PDF 导出都依赖这些字段，缺失时导出按钮可能处于不可用状态。如果你手头已经有一份旧简历，不用从头打字：导入功能支持 JSON Resume 格式，导入解析器就在 packages/import/，操作说明见 docs/guides/importing-resumes.mdx。另外，分区支持拖拽排序，想调整"技能"在"经历"前面这种顺序，直接拖就行。

🎨 选模板的三问决策法

内置模板有 15 套，源码都在 packages/pdf/src/templates/ 下，用宝可梦命名（Azurill、Ditto、Pikachu、Onyx、Scizor……）。别在画廊里一套套盲点，先回答三个问题：

第一问：内容多不多？内容偏长就先挑排版紧凑的模板，宽松版式很容易把内容挤到第二页；配合前面提到的拖拽分区，把同类信息合并也能省空间。第二问：给谁看？投大型企业的招聘系统（ATS）就选结构简单的单栏版式、少用色块和图标；给邮件里会人工打开的招聘官，设计感强一点的完全没问题。第三问：纸张规格？国内投递选 A4，投北美选 Letter，页面规格在模板设置里切换，决策细节可以看 docs/guides/choosing-a-template.mdx。

如果选完模板后预览白屏或卡住，别急着断定"模板坏了"：先按Ctrl+Shift+R（Mac 上是Cmd+Shift+R）强制刷新排除缓存冲突，还不行就换一套更轻量的模板试试，问题大概率出在缓存而非模板本身。

📄 让 PDF 不再白屏的导出环节

内容和模板都定稿后，进入导出环节：PDF、DOCX、JSON 三种格式任选。自 v5.1.0 起，PDF 生成完全搬到了浏览器端（基于 @react-pdf/renderer），自托管部署不再需要 Browserless、Chromium 之类的外部打印服务，.env里遗留的PRINTER_*、BROWSERLESS_*变量也不再被读取。

这个环节两个高频坑，都能两步解决。导出按钮灰色不可用？九成是必填字段为空，回头看表单里的红色校验提示补全即可，不用去翻后端日志。导出的 PDF 打开是空白？先强制刷新再导一次；仍不行就换轻量模板，复杂排版在个别环境下的渲染负担更大。更多导出细节（比如 Markdown 导出）在 docs/guides/exporting-your-resume.mdx。

🧩 顺手处理的三件事：语言、AI 与备份时机

这三件小事建议趁热一起做完，后面就很难再回来碰。

界面语言。UI 支持五十多种语言，语言包是 apps/web/locales/ 下的.po文件，加载规则由 apps/web/lingui.config.ts 定义。如果切换语言后界面没反应，先确认目标语言的.po文件确实存在；文件在的话，清掉该站点的浏览器数据再重新选一次，通常就恢复了。

AI 辅助写作。工作经历不知道怎么措辞时，可以让 AI 帮你改写，支持 OpenAI、Google Gemini、Anthropic Claude 这几家模型提供商。配置后 AI 功能不可用，按"密钥格式 → 账户余额 → 请求日志"的顺序排查，错误类型基本都会体现在日志里。入门用法见 docs/guides/using-ai.mdx，把 AI 当协作者深度改稿可以看 docs/guides/using-ai-agent.mdx。

什么时候该备份。我的经验规则是两条：每次大改之后导一份 JSON，切换模板之前再导一份。JSON 本质就是简历的数据文件，之后换设备、换实例（官方的或自托管的）都能直接导入，是最稳的保险。如果还想进一步控制字体、颜色和间距，docs/applying-custom-styles.mdx 讲了自定义样式的玩法。

Reactive Resume 给你的，是一份数据躺在自己磁盘上、随时能一键带走的可信简历工具。现在就可以做一件事：打开构建器，把第一段工作经历填完并导出一份 PDF——排版对不对都好说，先手里有一版能迭代的成品。

【免费下载链接】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