billryan/resume · 上手攻略

仓库：billryan/resume
链接：https://github.com/billryan/resume
分类：academic-writing（学术写作 · 简历模板）
作者：Jay
更新：2026-07-14

一、是什么

billryan/resume 是一个优雅的 XeLaTeX 简历模板，基于 MIT 协议开源，由上海交通大学学生 Bill Yuan（@billryan）创建和维护。该模板设计简洁、排版专业，支持英文和简体中文（UTF-8 完整支持），自带简历照片版本和 FontAwesome 图标集成，是中文技术圈最受欢迎的 LaTeX 简历模板之一。

GitHub Stars 11263， fork 2400+，广泛流传于留学申请和互联网技术求职圈。

分支说明： - master：英文简历模板 - zh_CN：简体中文简历模板（包含中文字体支持）

二、解决什么问题

简历排版丑：Word 排版难以保证跨平台一致性，不同人的 Word 版本差异会导致格式错乱
中文字体头疼：LaTeX 处理中文历来是痛点，该模板开箱支持中文无需额外折腾
图标添加繁琐：联系方式（邮箱、电话、LinkedIn、GitHub）需要手工画图标或用特殊字符，该模板集成 FontAwesome，一行代码搞定
照片版本割裂：许多模板不带照片版，或带照片版需要另起一套样式，该模板同一文件支持有无照片两种输出

三、快速安装

方式一：Overleaf 在线编辑（最简单）

打开 Overleaf 模板：https://www.overleaf.com/latex/templates/bill-ryans-elegant-latex-resume/xcqmhktmzmsw
注册/登录 Overleaf
点击 Open as Template
直接在网页编辑器中修改个人信息，一键编译为 PDF

Overleaf 编译 XeLaTeX：确保编辑器设置中 Compiler 选择 XeLaTeX（点击左上角 Menu → Compiler → XeLaTeX）

方式二：克隆到本地

仅克隆英文分支（推荐国内用户，避免字体包过大）：

git clone https://github.com/billryan/resume.git --branch master --depth 1 --single-branch resume-en
cd resume-en

克隆完整仓库（含中文字体，约较大）：

git clone https://github.com/billryan/resume.git
cd resume
git checkout zh_CN  # 切换中文分支

方式三：GitHub 在线编辑（无需本地环境）

Fork 本仓库
在 GitHub 网页上直接编辑 resume.tex 文件
用 GitHub 内置或 LaTeX.Online（https://latexonline.cc/）编译为 PDF

四、核心用法

4.1 本地编译（需安装 XeLaTeX 环境）

macOS：

# 安装 MacTeX
brew install --cask mactex

# 编译
xelatex resume.tex

Linux（Ubuntu/Debian）：

# 安装 XeLaTeX 和字体
sudo apt-get update
sudo apt-get install texlive-xetex fontconfig

# 如果需要中文字体
sudo apt-get install fonts-noto fonts-wqy-microhei

# 编译
xelatex resume.tex

Windows（WSL2 或原生）：

# Windows 10/11 可直接安装 TeX Live
# 下载 https://mirror.ctan.org/systems/texlive/tlnet/install-tl-windows.exe

# 或使用 WSL2 + Ubuntu
wsl --install -d Ubuntu
sudo apt install texlive-xetex
xelatex resume.tex

⚠️ macOS 用户注意：如果使用 MacTeX 包，TeX Gyre Termes 字体（英文正文字体）需要自行下载或使用系统已有字体。如编译报字体缺失，可注释掉 resume.cls 中对 texgyretermes 字体的引用，改用系统默认字体。

4.2 核心命令与结构

基础个人信息命令：

% !TEX program = xelatex
\documentclass{resume}

\begin{document}
\pagenumbering{gobble} % 隐藏页码

\name{你的名字}
\basicInfo{
  \email{your@email.com} \textperiodcentered\
  \phone{(+86) 138-0000-0000} \textperiodcentered\
  \linkedin[billryan8]{https://linkedin.com/in/billryan8}
}

章节命令：

\section{\faGraduationCap\ Education}  % 教育经历
\datedsubsection{\textbf{学校名称}, 城市}{2020 -- 2024}
\textit{学位} in 专业名称
期望毕业年份

\section{\faUsers\ Experience}  % 工作/实习经历
\datedsubsection{\textbf{公司名称}, 城市}{2022 -- Present}
\role{职位}{经理: 姓名}
简介文字
\begin{itemize}
  \item 成就1：实现了某某功能
  \item 成就2：优化了某某性能 20\%
  \item 成就3：……
\end{itemize}

技能章节：

\section{\faCogs\ Skills}
\begin{itemize}[parsep=0.5ex]
  \item 编程语言: Python == C++ > Java > Go
  \item 平台: Linux, macOS, Docker
  \item 开发: Web, API Design, Git
\end{itemize}

奖项章节：

\section{\faHeartO\ Honors and Awards}
\datedline{\textit{一等奖学金}, xxx 大学}{2023}
\datedline{优秀学生干部}{2022}

4.3 中文字体配置（zh_CN 分支）

中文分支提供两种字体方案：

% 方案一：使用系统内嵌 Adobe 字体（字体文件随仓库下载）
\usepackage{zh_CN-Adobefonts_internal}

% 方案二：使用外部字体文件（需从 Adobe 购买或合法获取）
\usepackage{zh_CN-Adobefonts_external}

⚠️ 中文字体说明：Adobe 思源宋体/黑体需合法授权。方案二依赖仓库附带的字体文件（可能因版权原因较大），推荐国内用户使用思源黑体（Noto Sans CJK）替代方案：

\usepackage{fontspec}
\setmainfont{Noto Sans CJK SC}

4.4 照片版本

仓库中 resume_photo.tex 文件为含照片版，在 \basicInfo 区块加入照片宏即可：

% 在 resume.tex 的 \name 之后加入：
\vspace{1.5ex}
\centerline{\includegraphics[width=0.15\textwidth]{avatar.jpg}}

注意：avatar.jpg 需放在仓库根目录，并确保 LaTeX 能找到图片路径。

4.5 Makefile 编译（推荐）

仓库自带 Makefile：

make          # 编译英文版
make zh       # 编译中文版
make clean    # 清理辅助文件

使用 latexmk 自动处理多次编译（LaTeX 需要多次编译才能生成目录/引用）：

latexmk -xelatex resume.tex

五、典型适用场景

场景	说明
互联网技术岗位求职	代码风格设计，适合程序员/工程师简历
留学申请英文简历	学术风格，理工科申请适用
金融/咨询类中文简历	切换 zh_CN 分支，中英文双语输出
快速制作一页简历	LaTeX 自然强制单页，格式约束友好
GitHub Profile 维护	Fork 后在线编辑，零成本版本控制

六、坑与注意

XeLaTeX 是必须的：模板大量使用 \XeTeX 特性（如 fontspec 的 OpenType 字体加载、xunicode），使用 pdflatex 会直接报错。确保编译器选择 XeLaTeX。
FontAwesome 版本锁定：模板使用 FontAwesome 4.6.3，新版本（5.x/6.x）图标名称有变化（如 fa-github → fa-brands fa-github），升级后图标可能失效。如果需要新图标，参考 FontAwesome 4.7 图标列表。
中文字体需要自行处理：英文用户无需额外配置；中文用户如果本地没有 Adobe 字体，需要切换到开源方案（思源黑体/Noto CJK），否则编译会报字体缺失错误。
照片版本需要图片路径：LaTeX 编译时需要能找到照片文件，建议将 avatar.jpg 放在与 .tex 同目录下，使用相对路径引用。
简历太长会超出一页：LaTeX 默认不限制长度，需要手动精简内容。建议内容控制在 500 字（英文）以内，突出核心技能和成就。
GitHub 在线编辑 + LaTeX.Online 编译是最省事的组合，不需要本地安装 TeX 发行版，缺点是每次修改需要手动触发重新编译。
Overleaf 中文支持：Overleaf 对 XeLaTeX + 中文支持较好，但中文字体包可能需要额外上传；建议先在英文版测试好，再切换到中文分支。

七、与同类对比

模板	语言支持	生态	样式风格	学习成本
billryan/resume	中英双语	GitHub 11k Stars	简洁学术风	低（模板注释详细）
zachscrivena/simple-resume-cv	英文为主	活跃	极简商务风	中
posquit0/Awesome-CV	英文为主	11k Stars	现代商务风	中
latexcv	多语言	LaTeX 社区	多种模板	高（需自己搭建）
Word 简历模板	任意	N/A	可自定义	低但质量参差

billryan/resume 的独特优势： - 中文支持开箱即用，零配置 - FontAwesome 图标集成，一行代码加联系方式图标 - 模板代码注释清晰，适合学习和二次修改 - MIT 协议，商业使用无限制

八、一句话推荐

写技术简历，billryan/resume 是 LaTeX 新手最友好的选择——中文友好、图标丰富、学术风格，拿来即用，Fork 一份改改就能投。