解决基于Rcpp的R包在CRAN Linux虚拟机上的Makevars编译失败问题

问题背景 #

我开发的R包nonprobsvy基于Rcpp和RcppArmadillo开发，在M1芯片的macOS Sonoma 14.0设备上可正常安装，但提交CRAN时，Debian等Linux虚拟机编译失败，问题根源指向Makevars配置。

当前src/Makevars内容：

## Use the R_HOME indirection to support installations of multiple R version
#PKG_LIBS = `$(R_HOME)/bin/Rscript -e "Rcpp:::LdFlags()"` $(LAPACK_LIBS) $(BLAS_LIBS) $(FLIBS)

取消注释第二行后，本地编译报错：

ld: warning: search path '/opt/gfortran/lib/gcc/aarch64-apple-darwin20.0/12.2.0' not found
ld: library 'gfortran' not found
clang: error: linker command failed with exit code 1 (use -v to see invocation)
make: *** [nonprobsvy.so] Error 1
ERROR: compilation failed for package ‘nonprobsvy’
─  removing ‘/private/var/folders/yh/41pvj0v54_jfq6w138_b1z740000gn/T/RtmpyINTst/devtools_install_3b69498b0fdf/nonprobsvy’

曾尝试用configure文件通过环境变量区分本地与通用配置，本地安装正常，但CRAN环境问题仍未解决，已使用rhub包测试CRAN提交兼容性，需调整Makevars实现跨平台兼容。

解决方案 #

1. 最简Makevars配置（无需configure文件） #

替换src/Makevars内容为：

PKG_CPPFLAGS = $(SHLIB_OPENMP_CFLAGS)
PKG_LIBS = $(SHLIB_OPENMP_CFLAGS) $(LAPACK_LIBS) $(BLAS_LIBS) $(FLIBS)

• 关键说明：
  • RcppArmadillo已内置BLAS/LAPACK链接逻辑，无需手动调用Rcpp:::LdFlags()，会自动注入所需依赖
  • $(SHLIB_OPENMP_CFLAGS)为可选配置，若包中未使用OpenMP可直接移除
  • 保留$(LAPACK_LIBS) $(BLAS_LIBS) $(FLIBS)确保跨平台线性代数库链接的正确性

2. 为何要避免手动调用Rcpp:::LdFlags() #

• CRAN Linux环境的系统库路径配置严格，手动执行Rscript生成链接标志易引发路径冲突或权限问题
• macOS M1环境中，手动指定的gfortran路径可能不存在（如未安装Xcode Command Line Tools或gfortran），依赖R内置的$(FLIBS)会自动匹配系统可用的Fortran库

3. 跨平台兼容性验证 #

使用rhub包测试CRAN支持的主流平台：

library(rhub)
check_for_cran()

本地测试时，确保已安装Xcode Command Line Tools和gfortran（可通过brew install gcc安装）

4. 废弃原configure文件的原因 #

• CRAN不鼓励通过环境变量区分配置，统一的Makevars更符合CRAN包提交规范
• RcppArmadillo的自动配置逻辑已足够覆盖跨平台需求，无需手动生成Makevars内容

内容的提问来源于stack exchange，提问作者Łukasz Chrostowski