R包中data.table的.SD符号行为异常问题求助

我发现data.table的.SD符号存在异常行为：
定义函数：

min_ex = function(dt,bycols)
{
  dt_sub = dt[, .SD, .SDcols = bycols]
  print(dt_sub)
}

该函数预期接收data.table对象dt和列名字符向量bycols，输出指定列。当作为脚本一部分编译或独立source时，运行测试代码可正常输出目标列；但将该函数放入R包后，运行测试代码会输出“Null data.table (0 rows and 0 cols)”。我已准备最小示例包，安装后函数始终返回空表。

希望了解该函数在R包中行为异常的原因及解决方法。

已尝试的操作：

• 使用devtools::load_all或安装包，行为一致；直接从GitHub安装结果相同。
• 在R 4.2.2、data.table 1.14.8版本下，Linux和Windows系统均复现问题。
• 重命名函数参数，无变化。
• 调整data.table加载顺序、在包DESCRIPTION中导入data.table，无影响。
• 缺失bycols参数运行时无报错，反而输出所有列，与预期不符。

原因分析 #

这是因为data.table的非标准计算（NSE）机制在包环境中无法正确解析.SDcols的参数。当函数在包内运行时，.SDcols = bycols中的bycols是函数的局部变量，而data.table默认会在调用环境（而非函数自身的局部环境）中查找该变量，导致无法匹配到正确的列名向量，最终返回空表。

另外，缺失bycols时输出所有列，是因为当.SDcols未被正确赋值时，data.table会默认返回包含所有列的.SD。

解决方法 #

有两种可靠的修复方式：

方法1：使用..前缀引用上层变量 #

data.table支持用..前缀直接引用调用环境中的变量，这是最简洁的官方推荐方式：

min_ex = function(dt, bycols) {
  dt_sub = dt[, .SD, .SDcols = ..bycols]
  print(dt_sub)
}

方法2：用get()显式指定变量环境 #

通过get()函数将bycols绑定到函数的局部环境，确保data.table能正确找到参数：

min_ex = function(dt, bycols) {
  dt_sub = dt[, .SD, .SDcols = get("bycols", envir = parent.frame())]
  print(dt_sub)
}

额外优化：添加类型检查 #

为了让函数更健壮，可以在开头添加data.table类型验证：

min_ex = function(dt, bycols) {
  stopifnot(inherits(dt, "data.table"))
  dt_sub = dt[, .SD, .SDcols = ..bycols]
  print(dt_sub)
}

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