Resume-NG编译问题清单：LaTeX简历10个高频报错与快速解决方案

Resume-NG编译问题清单LaTeX简历10个高频报错与快速解决方案【免费下载链接】resume-ngA LaTeX resume template designed for optimal information density and aesthetic appeal.项目地址: https://gitcode.com/gh_mirrors/re/resume-ngResume-NG 是一个追求高信息密度与美观排版的LaTeX 简历模板开源 LaTeX 简历项目。本文面向新手整理使用 Resume-NG 编译 LaTeX 简历时最容易撞上的10 个高频编译报错并逐一给出原因与快速解决方案帮你少走弯路、一次编译通过。动手前先花 30 秒自查 排查报错前先确认下面三件事能避开一半的问题是否装了 LaTeX 发行版推荐完整版 TeX Live 或 MiKTeX。是否用对引擎本项目默认用XeLaTeX编译见main.tex首行% !TeX TS-program xelatexlatexmkrc中$pdf_mode 5。文件是否齐全仓库根目录需同时存在main.tex、resume.cls、latexmkrc。如果需要克隆仓库可执行git clone https://gitcode.com/gh_mirrors/re/resume-ng 日常编译只需在项目根目录运行latexmk它会按配置自动调用 XeLaTeX 并生成 PDF。Resume-NG 的宏包依赖一览 本项目在resume.cls中声明了如下依赖具体见readme.md的“包依赖”章节主流发行版一般开箱即用精简环境需按需补装宏包作用ctex中文排版提供ctexart文档类geometry页面与边距设置A4、1cm 边距fancyhdr页眉页脚本项目已清空enumitem列表间距与样式\setlistfootmisc脚注排成一行para选项hyperref超链接与 PDF 书签\pdfbookmarkxeCJKfntef中文字体特效\CJKunderline下划线xcolor颜色如\GrayText的灰色10 个高频报错与快速解决方案 报错 1latexmk / xelatex 命令找不到报错信息bash: latexmk: command not found或xelatex: command not found原因没有安装 LaTeX 发行版。解决安装完整版 TeX Live推荐或 MiKTeX装完重开一个终端再运行latexmk。报错 2用 pdflatex 编译ctex 报引擎错误报错信息! LaTeX Error: (ctex) ctexart.cls requires xelatex or lualatex.原因手动用了pdflatex main.tex而模板依赖 xeCJK必须走 XeLaTeX。解决直接用latexmk或显式xelatex main.tex通常需跑两遍在 Overleaf 上把编译器选成XeLaTeX。报错 3File ctex.sty not found缺宏包报错信息! LaTeX Error: File ctex.sty not found.也可能报xeCJKfntef.sty、footmisc.sty原因精简版 TeX Live 缺少依赖宏包。解决按依赖清单补装例如 TeX Live 执行tlmgr install ctex xeCJKfntef footmisc enumitemMiKTeX 可在设置中勾选安装缺失包。报错 4xeCJK 找不到中文字体报错信息! xeCJK Error: (Fatal) Cannot find font SimSun.或Font ... not loadable原因系统缺少中文宋体 / 黑体等字体新系统、精简环境常见。解决安装中文字体如 Noto CJK / 思源宋体、黑体或重装包含 CJK 字体的 TeX Live必要时在导言区显式指定中文字体。报错 5\ResumeName 等命令未定义报错信息! Undefined control sequence. l.5 \ResumeName{...}原因resume.cls缺失或\documentclass{resume}写错 / 漏写。解决确认main.tex与resume.cls在同一目录且main.tex里确实是\documentclass{resume}。报错 6Extra } / Missing {大括号不匹配报错信息! Extra }.或! Missing { inserted.原因\ResumeContacts{...}、\ResumeItem{...}等大括号没配对或联系方式里括号 / 逗号多打。解决逐一检查花括号是否成对联系方式之间用英文逗号分隔行尾可用%续行参考main.tex写法。报错 7\ResumeItem 参数顺序写错报错信息! Too many or too few arguments.或书签 / 日期错位原因\ResumeItem签名为[书签]{标题}[补充][右对齐]可选参数写在前面顺序写错会错位。解决严格按[可选书签]{必需标题}[可选补充][可选右对齐]的顺序填写。报错 8\pdfbookmark 未定义报错信息! Undefined control sequence. ... \pdfbookmark原因未加载hyperrefresume.cls默认已加载自行删改后会触发。解决保留\RequirePackage{hyperref}不要移除该依赖。报错 9\CJKunderline 未定义\ResumeUrl 报错报错信息! Undefined control sequence. ... \CJKunderline原因未加载xeCJKfntef而\ResumeUrl的下划线效果依赖它。解决确保xeCJKfntef已安装并随resume.cls正常加载。报错 10File image.png not found插入照片图片缺失报错信息! LaTeX Error: File image.png not found.原因取消了照片插入代码的注释但图片文件名或路径不对。解决把照片放到与main.tex同一目录文件名与\includegraphics[width2cm]{image.png}保持一致换成自己的照片时同步修改文件名。报错排查小技巧 ⚡只看第一处!LaTeX 日志里的报错常会连锁优先处理第一处带!的行后面的多是连锁反应。看具体出错行号l.5表示第 5 行直接跳过去核对大括号与参数。干净重编译改动较大后删掉.aux/.log等中间文件再跑latexmk避免旧缓存干扰。不确定就换在线编译在 Overleaf 等平台新建项目并上传文件把引擎设为 XeLaTeX日志更清晰、便于定位。✅ 按上面清单从上到下排查绝大多数 Resume-NG 编译问题都能在几分钟内解决。遇到新的报错先复制第一处!那一行去搜索通常能立刻定位原因。【免费下载链接】resume-ngA LaTeX resume template designed for optimal information density and aesthetic appeal.项目地址: https://gitcode.com/gh_mirrors/re/resume-ng创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考