使用devtools出错后，如何从rlang获取更详细诊断信息？

1. 直接调用底层命令获取详细日志 #

devtools的build_manual()是封装了R CMD Rd2pdf的工具，直接运行带 verbose 参数的底层命令，能拿到更原始的错误输出：

system("R CMD Rd2pdf --verbose .")

--verbose会打印所有中间过程，包括LaTeX编译的具体错误（比如字体缺失、Rd文档语法问题），这通常能直接定位根源。

2. 逐行检查Rd文档语法 #

即便devtools::check_man()没报错，也可能存在Rd文档的隐性语法问题：

• 检查man/目录下所有.Rd文件，确保\title、\description、\usage等标签的大括号、反斜杠闭合完整
• 验证\code{\link{func}}里的函数名拼写正确、确实存在于包中
• 避免在Rd文本里使用全角符号、特殊转义字符，这类内容会导致LaTeX编译失败

3. 验证LaTeX运行环境 #

PDF文档构建依赖LaTeX环境，可能是环境缺失组件导致：

• 用tinytex::check_installed()检查tinytex组件是否完整，缺失的话用tinytex::tlmgr_install()安装对应包（比如必要的字体、编译工具）
• 手动编译一个简单的LaTeX测试文件，确认LaTeX环境本身能正常工作

4. 逐步简化包结构定位问题 #

继续简化包内容，缩小错误范围：

• 临时注释NAMESPACE里的大部分导出，只保留一个最简单的测试函数
• 删除man/目录下除该测试函数对应Rd文件外的所有文档
• 再次运行build_manual()，如果成功，再逐步恢复内容，找到触发错误的具体部分

5. 检查DESCRIPTION文件的合法性 #

DESCRIPTION字段错误也可能引发文档构建失败：

• 确认Title、Description字段无特殊字符或格式错误
• 检查Depends、Imports里的包都已正确安装，版本符合要求
• 确保Encoding字段设置正确（比如Encoding: UTF-8）

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