hijiangtao/resume · 上手攻略

  • 仓库：hijiangtao/resume
  • 链接：https://github.com/hijiangtao/resume
  • 分类：academic-writing
  • 作者：Tom
  • 更新：2026-08-09

是什么

hijiangtao/resume 是一个优雅的中文简历 LaTeX 模板，基于 XeLaTeX 编译，专门解决中文简历排版难题。fork 自 billryan/resume，在原版基础上强化了中文支持，完善了 Adobe 四套中文字体集成，是中文技术简历场景下最易用、最美观的开源模板之一。

解决什么问题

中文简历排版的几个常见痛点：

  • 中文字体：传统 LaTeX 模板对中文支持差，常出现字体缺失或排版错乱
  • 编译工具链：需要手动配置 XeLaTeX + fontspec + 字体文件，门槛高
  • 样式定制：moderncv 等主流模板不适合一页纸简历，res 模板又过于简陋
  • 在线协作：团队招聘或留学申请需要不同人协作编辑

本模板通过预配置的字体包、详细的宏定义和 OverLeaf 在线编译支持，把中文简历制作门槛降到最低。

快速安装

方式一：OverLeaf 在线编译（推荐零配置）

  1. 将 GitHub 仓库 clone 或下载为 zip
  2. 上传至 OverLeaf（免费账号即可）
  3. 编译器选择 XeLaTeX
  4. 直接编译 resume-zh_CN.tex

⚠️ OverLeaf 编译需使用 zh_CN-Adobefonts_external 宏包（不依赖本地字体）。

方式二：本地编译

# 克隆仓库（master 分支含完整中文字体，约 37MB）
git clone https://github.com/hijiangtao/resume.git --branch master --depth 1 --single-branch <folder>
cd <folder>

# 编译（需要 XeLaTeX，macOS 推荐 MacTeX，Linux 推荐 texlive-full）
xelatex resume-zh_CN.tex

核心用法

基础宏使用

% 文档类加载（在 resume.cls 中已预配置）
\documentclass{resume}

% 姓名
\name{张三}

% 联系方式（三项：邮箱 / 手机 / 个人主页）
\contactInfo{zhangsan@example.com}{138-0000-0000}{https://zhangsan.io}

% 或简版联系方式（无个人主页时）
\basicContactInfo{zhangsan@example.com}{138-0000-0000}

% 简历正文示例
\begin{document}

\section{教育背景}
\datedsubsection{清华大学}{2022 -- 至今}
计算机科学与技术 · 硕士

\section{实习经历}
\datedsubsection{字节跳动}{2024.06 -- 2024.09}
后端开发工程师
{itemize}
\item 参与抖音推荐系统后端架构优化，QPS 提升 40\%
\item 设计并实现用户行为数据采集 pipeline，日处理量 10TB+
\end{itemize}

\section{项目经历}
\datedsubsection{Vue3 Component Library}{2024.01 -- 2024.05}
前端开源项目 · 500+ GitHub Stars
{itemize}
\item 基于 Vue3 Composition API 开发组件库，涵盖 30+ 通用组件
\item 支持按需引入和 Tree-shaking，体积缩小 60\%
\end{itemize}

\section{技能}
{itemize}
\item 前端：Vue / React / TypeScript / CSS / Webpack
\item 后端：Node.js / Python / Go / MySQL / Redis
\item 工具：Git / Docker / Kubernetes / CI/CD
\end{itemize}

\end{document}

Font Awesome 图标使用

从 Font Awesome Icons 挑选图标后，在 fontawesome.sty 中找到对应宏，直接插入文本：

\section{联系方式}
\datedsubsection{\faGithub{} GitHub: hijiangtao}{2022 -- 现在}
\datedsubsection{\faEnvelope{} Email: zhangsan@example.com}{}

⚠️ 目前暂不支持 Font Awesome 别名功能，需使用完整图标名称。

中文字体配置

模板提供两套字体宏包策略：

宏包 适用场景 依赖
zh_CN-Adobefonts_internal 本地已安装 Adobe 四套中文字体 需要系统已装 37MB 字体包
zh_CN-Adobefonts_external OverLeaf / 无本地字体 使用 ShareLatex/OverLeaf 内置字体

典型适用场景

  1. 中文技术简历：软件工程师、算法工程师、设计师等需要一页纸简历的场景
  2. 留学申请：部分海外院校接受 LaTeX 简历，直接复用模板
  3. 内推/招聘：中文简历排版美观度直接影响 HR 初筛印象
  4. GitHub Profile 配套：配合个人 GitHub 页面展示专业形象
  5. 批量生成不同版本：用同一模板维护技术版/管理版/留学版等不同风格简历

坑与注意

  1. 必须使用 XeLaTeX 编译器：模板使用了 fontspec 宏包处理 OpenType 字体，pdfLaTeX 和 LaTeX 均不支持。

  2. Adobe 中文字体版权：字体文件（.otf）受版权保护，master 分支附带的字体包仅供个人使用，模板本身 MIT 许可，但字体需自行确认授权。

  3. OverLeaf 版本兼容性：OverLeaf 的 TeX Live 发行版可能缺少部分字体；若编译报错，尝试切换到 XeLaTeX 编译器，或使用 zh_CN-Adobefonts_external 宏包。

  4. 中文断行/标点处理：XeLaTeX 对中文标点压缩处理有时会导致行间距不均，可在 .tex 文件中加入 \punctstyle{quanjun} 改善。

  5. 多人协作：若团队内非技术成员需要编辑简历，建议通过 OverLeaf 共享项目（只读权限），避免 LaTeX 环境配置问题。

与同类对比

特性 hijiangtao/resume billryan/resume（原始） moderncv res（ctan）
中文支持 ✅ 完整（Adobe 字体） ✅ 中文分支 ⚠️ 需手动配置 ❌ 无
XeLaTeX ✅ ✅ ⚠️ ❌
OverLeaf 兼容 ✅ ✅ ⚠️ ❌
Font Awesome ✅ ✅ ✅ ❌
一页纸布局 ✅ ✅ ❌（较长） ⚠️
样式定制 中 中 高 低
活跃维护 ✅（2026更新） ⚠️（停更） ✅ ✅

moderncv 适合学术 CV（Academic CV）场景；res 过于基础；hijiangtao/resume 是中文技术简历的首选。

一句话推荐结论

写中文技术简历，用这个模板而不是 Word——一行命令编译出排版精美的一页纸 PDF，配合 OverLeaf 在线编辑完全零门槛，比任何简历制作网站都更专业。

最小可跑命令（核验路径）

# 环境：XeLaTeX（texlive-full / MacTeX），磁盘 500MB
# 方式一：OverLeaf（零配置）
# 1. https://github.com/hijiangtao/resume → Download ZIP
# 2. OverLeaf → New Project → Upload ZIP
# 3. 编译器选 XeLaTeX → 编译 resume-zh_CN.tex
# 预期：生成 PDF，一页 A4，中文正常显示

# 方式二：本地
# 1. 安装 MacTeX（macOS）或 texlive（Linux）
# 2. xelatex --version  # 确认 XeLaTeX 可用
# 3. git clone https://github.com/hijiangtao/resume.git --branch master
# 4. xelatex resume-zh_CN.tex
# 预期：同 OverLeaf，生成 resume-zh_CN.pdf
# 硬件要求：无特殊，任何能跑 LaTeX 的机器均可

⚠️ 本地编译如提示字体缺失，说明 Adobe 字体未安装；切到 OverLeaf 使用 zh_CN-Adobefonts_external 宏包可绕过此问题。

原始 commit：https://github.com/hijiangtao/resume/commit/30ca6c3 · MIT License（字体文件版权单独）· 作者 Joe Jiang