检查R包时如何解决「Font shape undefined」类LaTeX报错问题

你提供的LaTeX日志仅包含字体替换警告，PDF实际已经生成成功，R CMD CHECK抛出的错误提示本质是Rd文件中的特殊符号未正确转义触发的语法检测告警，可按以下步骤排查修复：

1 定位问题Rd文件 #

• 运行R CMD Rd2pdf man/单独生成手册PDF，执行过程中会输出当前处理的Rd文件名，找到对应提示「input line 20」的目标Rd文件
• 也可直接遍历man目录下所有.Rd后缀文件，搜索<（小于号）字符，重点排查\description{}、\details{}、\value{}等文本块，以及\code{}、\verb{}等格式块内的小于号

2 修复特殊符号转义 #

Rd语法对部分特殊符号有专属转义要求：

• 文本/代码格式块内的<替换为\textless{}
• 文本/代码格式块内的>替换为\textgreater{}
• 注意\examples{}块内的可执行代码不需要做上述转义

3 修复LaTeX字体依赖（仅适用于Linux环境） #

如果是在无图形界面的Linux服务器上运行检查，缺失基础字体包也会触发该警告，可安装对应依赖：

• Debian/Ubuntu 系：sudo apt install texlive-fonts-recommended texlive-latex-extra
• CentOS/RHEL 系：sudo yum install texlive-amsfonts texlive-collection-latexextra

4 验证修复效果 #

重新运行R CMD check <你的包名>，确认LaTeX相关告警消失即可。

内容的提问来源于stack exchange，提问作者Faustin Gashakamba