如何让remotes::install_*()通过roxygen2生成R包文档？

核心解决方案：让安装过程自动触发roxygen2生成手册页 #

不需要每次手动执行，通过remotes::install_git()的参数配置即可实现：

1. 确保包的DESCRIPTION文件包含RoxygenNote字段
   这是R构建工具识别需要运行roxygen2的关键，示例：

   RoxygenNote: 7.2.3
   

   版本号对应你实际使用的roxygen2版本。

2. 使用带构建参数的install_git命令
   设置build = TRUE，让remotes先执行标准的R包构建流程（会自动调用roxygen2生成man/*.Rd文件），再安装构建后的包：

   remotes::install_git("你的Git仓库URL", build = TRUE)
   

   如果需要跳过非必要的构建步骤（比如 vignette 编译），可以添加构建选项：

   remotes::install_git("你的Git仓库URL", build = TRUE, build_opts = c("--no-resave-data", "--no-build-vignettes"))
   

替代方案：用devtools简化流程 #

如果你已经在使用devtools生态，devtools::install_git()默认会自动处理roxygen2文档生成，无需额外参数：

devtools::install_git("你的Git仓库URL")

问题原因说明 #

你遇到的No man pages found提示，是因为remotes::install_git()默认行为是直接将Git仓库中的源码复制到R库，不会触发R包的构建流程——而roxygen2生成手册页的步骤属于构建环节的一部分。设置build = TRUE后，工具会先执行R CMD build，该命令会检查DESCRIPTION中的RoxygenNote字段，自动调用roxygen2生成缺失的man文件，再完成安装。

手动生成的备选方法 #

如果自动构建方案不生效，也可以手动生成手册页后再安装：

1. 克隆仓库到本地服务器：

   git2r::clone("你的Git仓库URL", local_path = "./BOB")
   

2. 生成手册页：

   roxygen2::roxygenize("./BOB")
   

3. 安装本地包：

   remotes::install_local("./BOB")
   

内容的提问来源于stack exchange，提问作者Ryan C. Thompson