jankapunkt/latexcv · 上手攻略

• 仓库：jankapunkt/latexcv
• 链接：https://github.com/jankapunkt/latexcv
• 分类：academic-writing · productivity
• 作者：Tom
• 更新：2026-08-14

这是什么

latexcv 是 Jan Küster 开发维护的 LaTeX 简历（CV）和履历表模板集合，目前在 GitHub 上被广泛使用。所有模板均为原创设计，非从模板网站复制，代码自行实现，结构清晰、注释完整。

项目特色： - 8 种版式：Classic / Modern / Minimalistic / Two Column / Sidebar / Sidebar Left / Row Layout / Infographics / Infographics 2 - 中文支持：通过 CJK 宏包支持中日韩字符，最少仅需两行配置 - Overleaf 在线编辑：大部分模板可直接在 Overleaf 上线使用，无需本地安装 LaTeX - MIT 许可证：可自由修改和商用 - Docker 支持：提供标准化编译环境，避免本地 texlive 配置地狱

解决什么问题

用 Word 或在线工具做简历，格式不专业、排版难精确控制、跨平台表现不一致。LaTeX 简历模板解决了"内容与样式分离"的问题——你只管填入个人信息，模板自动保证版式精美、字体统一、PDF 输出质量高，尤其适合：

• 学术岗位申请（需要正式的 Publication List、Conference Presentations 等section）
• 申请外企或跨国公司（英文简历更规范）
• 需要频繁更新简历内容的技术人员（LaTeX 源码改内容比 Word 调格式快）

快速安装

方案一：Overleaf 在线编辑（推荐新手）

无需安装任何软件，直接在 Overleaf 上编辑并编译 PDF：

步骤：点击链接 → "Open as Template" → 用自己的内容替换模板中的占位文本 → 点击编译（Compile）→ 下载 PDF。

方案二：本地编译（Docker 方式）

适合需要本地自动化构建或 CI/CD 场景：

# 1. 确保已安装 Docker（https://docs.docker.com/get-docker/）

# 2. 克隆仓库
git clone https://github.com/jankapunkt/latexcv.git
cd latexcv

# 3. 构建 Docker 镜像（仅需运行一次）
.docker/create_image.sh

# 4. 编译指定模板（如 classic）
.docker/build.sh classic

# 输出文件：classic/main.pdf

多次编译时可用 daemon 模式：

# 启动后台守护进程
.docker/daemon.sh

# 连续编译多个模板
.docker/dbuild.sh modern
.docker/dbuild.sh sidebar

方案三：本地 TeX Live 安装

# Ubuntu/Debian 安装基础 texlive（不含完整 2GB 发行版）
sudo apt-get install texlive-latex-base texlive-latex-extra

# 或安装完整中文支持（推荐）
sudo apt-get install latex-cjk-all

# 克隆模板
git clone https://github.com/jankapunkt/latexcv.git
cd latexcv/classic  # 以 Classic 模板为例

# 编辑 main.tex 填入个人信息

# 编译
pdflatex main.tex
# 如有 bibtex 参考文献，运行：
# bibtex main && pdflatex main.tex && pdflatex main.tex

⚠️ texlive 完整安装包约 2GB，latex-cjk-all 约 400MB。建议先用 Docker 镜像或 Overleaf 试用，确认需要本地编译后再处理。

核心用法

选择合适的模板

修改 main.tex 的基本结构

以 Classic 模板为例，核心结构如下：

\documentclass[11pt]{article}
\usepackage[utf8]{inputenc}
\usepackage{latexcv}  % 引入 latexcv 样式

\begin{document}
% 个人信息区
\name{张三}
\tagline{软件工程师}
\email{zhangsan@example.com}
\github{github.com/zhangsan}
\linkedin{linkedin.com/in/zhangsan}

% 教育经历
\section*{教育经历}
\cvitem{2020–2024}{博士，清华大学计算机系}{导师：李教授}
\cvitem{2016–2020}{本科，北京大学}{ GPA 3.8/4.0}

% 工作经历
\section*{工作经历}
\cvitem{2024–至今}{字节跳动}{后端工程师}
\itemcontent{负责推荐系统架构优化，QPS 提升 40\%}

\section*{技能}
\cvitem{编程语言}{Python, Go, Rust}
\cvitem{框架}{FastAPI, gRPC, Kubernetes}
\end{document}

中文支持（重点）

在任意模板的 main.tex 顶部添加：

\def\cjklang{gbsn}  % 简体中文
\input{../cjk/cjk.tex}  % 引入 CJK 配置

cjklang 可选值： - 简体中文：gbsn 或 gkai - 繁体中文：bmsi 或 bkai - 日语：min（明朝）、goth（ゴシック）、maru（丸ゴシック） - 韩语：mj（MyeongJu）

CJK 环境由 cjk.tex 通过 \AfterEndPreamble 和 \AtEndDocument 自动添加，不需要手动 wrap。

⚠️ 注意：如果编译报错 ! PACKAGE INPUTENC ERROR: UNICODE CHAR NOT SET UP FOR USE WITH LATEX，可能是 CJK 环境被放在了 header 定义命令（如 \section）内部。解决思路参考：tex.stackexchange #478696

自定义颜色

% 在 \begin{document} 前定义主题色
\definecolor{primary}{RGB}{0, 102, 204}  % 蓝

编译生成 PDF

# 方式1: 直接 pdflatex（需要完整 texlive）
pdflatex main.tex

# 方式2: Docker（无需本地 texlive）
cd latexcv
.docker/create_image.sh
.docker/build.sh classic
# 输出：classic/main.pdf

典型适用场景

• 留学申请：需要英文简历和申请文书，欧洲学术岗位常用 LaTeX 版简历
• 博士/博后申请：Publication List、Conference Presentations 等学术专属 section 模板支持
• 技术面试简历：突出项目经验、技能树，适合互联网/外企求职
• 个人主页展示：GitHub Pages 或个人网站嵌入 PDF 版简历
• 设计岗：Infographics 模板做设计师作品集或创意简历

坑与注意

模板不等于内容

LaTeX 模板只保证排版精美，不保证内容质量。简历内容本身（如何量化成果、如何用动词开头等）需要另行学习。

不同国家简历文化差异

该模板主要面向欧美求职市场，格式与中式简历不同（如不写"年龄""民族""政治面貌"）。如果目标是中国大陆企业，Classic 模板比 Modern 更稳妥。

texlive 安装位置问题

从 tug.org 安装 texlive 时注意 PATH 环境变量配置，确保 pdflatex 命令可全局调用。Docker 方案可完全绕开此问题。

CJK 字体渲染依赖系统字体

Linux 系统若缺少中文字体（如 Noto Sans CJK），PDF 中文可能显示为方块。Overleaf 和 Docker 镜像通常已包含中日韩字体，本地安装需额外处理。

模板更新维护

原作者 2014-2021 年活跃，之后由社区维护。GitHub 上有少量更新但频率不高，大版本改动（如 API breaking）可能性低，已用模板可稳定继续使用。

非 XeTeX / LuaTeX 依赖

模板明确说明不需要 XeTeX 或 LuaTeX，只依赖标准 pdflatex + 标准宏包，降低了配置复杂度。

与同类对比

推荐策略： - 需要中文 → latexcv 是为数不多的 CJK 开源方案 - 英文简历追求 Stars 多、社区大 → Awesome-CV 更成熟 - 追求极简风格 → AltaCV - 新手不想折腾 LaTeX → Overleaf + latexcv 在线模板

一句话推荐结论

latexcv 是 LaTeX 简历领域少有的原生中文支持开源模板库，Overleaf 直接可用、Docker 编译无门槛，适合需要中英双语简历或追求版式精美的学术/技术求职者。