用途:从零创建新的 R 包,或把零散的 R 脚本整理为规范包结构,也可用于搭建便于协作开发的包骨架。
主要能力:通过 usethis 生成包骨架(DESCRIPTION、NAMESPACE、R/、man/),配置 DESCRIPTION 元数据,添加 MIT 许可证、README、NEWS、testthat(edition 3)、Git 仓库与 GitHub Actions 的 check-standard 工作流,创建 .Rprofile、.Renviron.example 与 .Rbuildignore,初始化 renv,生成包级文档文件与 CLAUDE.md。
必要用法:先执行 usethis::create_package("packagename") 并 setwd("packagename");随后按需运行 usethis::use_mit_license()、use_readme_md()、use_news_md()、use_testthat(edition = 3)、use_git()、use_github_action("check-standard"),再执行 renv::init()。需提供包名(小写,除 . 外无特殊字符)与一行用途描述;许可证默认 MIT,作者信息与是否初始化 renv 可选。
适用场景:新建 R 包、脚本包化、协作开发前的骨架搭建。
限制与注意:包名需先用 available::available("packagename") 检查是否与 CRAN 冲突;.Rbuildignore 必须排除 .Rprofile、.Renviron、renv/ 等开发文件;DESCRIPTION 需含 Encoding: UTF-8,RoxygenNote 须与已安装 roxygen2 版本一致;验证标准为 devtools::check() 无错误无警告、renv::status() 无问题。资料未提供具体收费、平台支持范围等信息。