使用.onLoad赋值外部包变量，devtools::check运行示例找不到变量

问题根源 #

你将myVar存入.GlobalEnv的做法不符合R包开发规范，R CMD check的示例执行环境是隔离的，不会自动继承全局环境的变量；另外globalVariables的声明仅能抑制检查时的NOTE，无法解决实际运行时变量不存在的问题。

正确解决方案 #

放弃使用.GlobalEnv，改用包内部专用环境存储可修改变量：

1. 创建包内部环境
   在包内新建env.R文件，定义独立的内部环境：

# 定义包专属环境，用于存储可修改的状态变量
.pkg_env <- new.env(parent = emptyenv())

2. 修改.onLoad函数
   在zzz.R中，将外部包的锁定变量复制到内部环境，而非全局环境：

.onLoad <- function(libname, pkgname) {
  # 复制外部包变量到内部环境
  .pkg_env$myVar <- externalPackage::myVar
  # 直接在此环境中修改变量（无需解锁外部包变量）
  # 示例：.pkg_env$myVar$setting <- "new_value"
}

3. 更新globalVariables声明
   在Package.R中，声明内部环境及变量以避免检查报错：

# 声明包内部环境和变量，抑制R CMD check的未定义变量NOTE
globalVariables(c(".pkg_env", "myVar"))

4. 在包函数中调用变量
   后续包内函数直接引用内部环境中的变量：

sample_function <- function() {
  # 使用包内部环境的myVar
  cat("当前变量值：", .pkg_env$myVar, "\n")
}

额外注意事项 #

• 永远不要依赖全局环境存储包的状态变量，这会导致包行为不可预测，尤其在多会话或并行加载场景下。
• 测试示例时，确保先通过devtools::load_all()加载包，R CMD check会自动完成包加载操作。

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