resume

一份 LaTeX 简历模板为何能收割上万 Star：拆解 sb2nov/resume

项目背景与痛点

程序员的简历有个悖论：内容越硬核，排版越容易被糟蹋。用 Word 写，跨平台字体漂移、行距塌陷、导出 PDF 页码错乱；用在线简历工具，模板花哨却过不了 ATS（申请人跟踪系统）——招聘系统拿不到结构化文本，关键词匹配直接判负；用 Markdown 生成，样式控制力又太弱，一页纸内的垂直空间寸土必争，Markdown 给不了你 -2pt 的行间距。

sb2nov/resume 切的正是这个缝隙：一份纯 LaTeX 写的单页软件工程师简历模板。它不做编辑器、不做 SaaS、不做拖拽，只交付一套排版契约——你在 .tex 文件里填内容，它保证输出一份紧凑、单栏、字体统一、机器可读的 PDF。对熟悉 Git 的开发者来说，简历从此变成代码：可 diff、可回滚、可为不同岗位开分支。

核心技术揭秘

这个项目的"架构"看似平淡，实则是一次对 LaTeX 的克制使用。它没有引入 moderncv 这类重型文档类，而是在 article 之上手写导言区，用 fullpage 抹掉默认页边距，用 titlesec 重定义 \section 的外观（小号大写字形 + 细横线），用 enumitem 把列表的左缩进压到 0.15in 并清空 label，用 hyperref 的 hidelinks 让链接可点击但不破坏黑白打印效果，再靠 fontawesome5 在联系方式行里塞图标。

真正决定成品观感的是那组自定义命令：\resumeSubheading（公司 / 职位 / 地点 / 时间四参数）、\resumeProjectHeading、\resumeItem、以及 \resumeSubHeadingListStart 这类列表包装器。它们把"两行式条目 + 右对齐日期 + 紧凑项目符号"这套排版模式固化成 API，内容区因此退化为纯数据填充。构建侧则是一个极薄的 Makefile，封装 pdflatex 的多次编译；大量用户实际走的是 Overleaf 云端编译，仓库同时充当模板源和依赖清单。

技术难点不在语法，而在垂直空间的极限压缩。一页纸要塞下教育、三到四段经历、若干项目、技能栈，模板里遍布 \vspace{-2pt}、\small、\scshape 这类手工微调。这套"负间距工程"极其有效，也极其脆弱：一旦换字体或改字号，整页布局会连锁位移，使用者不得不反复编译试错。这是它的能力上限，也是它的隐性成本。

功能亮点与差异

对比同类方案，它的差异化很清晰。

与 moderncv、Awesome-CV 相比：后两者提供了更华丽的文档类和更完整的配置项，但 Awesome-CV 强依赖特定字体与 fontspec，脱离 XeLaTeX 或字体缺失就编译失败；moderncv 的欧式版式（照片、彩色条）在北美科技公司语境里并不讨喜。sb2nov/resume 选择了最保守的 pdflatex 路径，依赖少、编译快、跨环境稳定——这是工程取舍，不是技术落后。

与 JSON Resume / RenderCV 这类"数据与排版分离"的新方案相比：它没有抽象层，内容与样式耦合在同一个 .tex 里。听起来是缺点，但对个人简历这种一次成型、极少复用的场景，抽象层带来的 YAML schema 学习成本和样式调试成本，往往大于收益。直接写 LaTeX，意味着排版自由度没有天花板。

杀手锏是 ATS 友好性：单栏流式布局、无表格、无文本框、无图形化技能条、标准 section 命名。用 pdftotext 提取后文本顺序与视觉顺序一致，关键词能被正常抓取。这一点上，绝大多数"漂亮"的在线简历模板都不合格。

应用场景与落地建议

适合：校招/社招的软件工程师、需要频繁针对 JD 微调简历的求职者、习惯 Git 工作流的开发者、需要多语言或多版本简历（按公司开分支，git diff 一目了然）。

不适合：设计岗、需要作品集视觉表现的岗位、非技术背景且不愿碰命令行的人。

落地时的几点实操建议：

1. 先验证文本层。编译后跑一遍 pdftotext resume.pdf -，确认输出顺序正确、没有乱码和断行错误，再投递。
2. 把内容层再抽一层。在仓库里维护 content/*.tex，主文件只负责 \input，这样针对不同岗位只需替换内容文件，排版宏不受污染。
3. 上 CI。加一个 GitHub Actions 工作流，用 xu-cheng/latex-action 在 push 时编译并产出 PDF artifact，彻底摆脱本地 TeX Live 的安装折磨，也顺手拿到版本化的简历归档。
4. 注意页面尺寸。模板默认 Letter，投国内或欧洲岗位时记得改 \usepackage[a4paper]{geometry}，否则打印会裁边。
5. 控制依赖漂移。fontawesome5 等宏包在不同 TeX Live 版本间图标名有过变更，锁定镜像版本能避免"昨天还能编译"的尴尬。

综合评价

优点：极简依赖、编译确定性高、ATS 友好、样式与内容同源因而无抽象损耗、Git 友好、社区验证充分（大量 fork 意味着各种边缘情况都被人踩过）。

缺点：没有数据抽象层，多版本维护靠复制粘贴；负间距 hack 使样式微调缺乏鲁棒性；无内置 CI 与自动化发布；对 LaTeX 零基础者门槛陡峭；模板本身多年演进缓慢，现代排版特性（如变量字体、自动布局）一概不涉。

一句话总结：它不是最先进的简历工具，而是在"可控、可读、可编译"这条窄路上做到了近乎最优解。如果你认同简历应该像代码一样被管理，这个仓库值得直接 fork 后长期持有。