build_site()无法渲染R包部分示例，终端运行正常求助

核心原因分析 #

终端运行正常但build_site()报错，本质是pkgdown构建站点时用的是独立R会话，和你终端的会话环境完全隔离——终端会话可能残留了之前加载的对象、包依赖，导致代码能跑通，但隔离环境里缺少必要的前置对象或依赖。

具体解决步骤 #

• 补全示例代码完整性：调用fast_classification()的示例里，rec_obj必须在当前代码块内定义，或者把生成rec_obj的代码明确写进去，别依赖会话里已有的对象。
• 显式加载依赖包：在示例开头加上library(tidyAML)和其他相关包的加载代码，pkgdown不会自动继承终端的包加载状态。
• 规范R文档示例写法：如果示例放在roxygen2的@examples标签里，确保代码自包含。要是有不需要渲染的代码用\dontrun{}包裹，但需要渲染的部分必须能独立运行。
• 清理构建缓存：先跑pkgdown::clean_site()，再重新执行build_site()，避免旧缓存干扰。
• 检查包依赖声明：确认你的R包的DESCRIPTION文件里，已经把tidyAML加到Imports或Depends字段，这样pkgdown构建时会自动加载依赖。
• 模拟隔离环境测试：新开一个R会话，直接复制示例代码运行，模拟pkgdown的构建环境。如果报错，说明代码确实缺依赖，得补全。

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