Mac OS 15.1下Rcpp编译Cpp文件时gfortran链接错误求助

问题背景 #

• 设备：Mac mini M4，MacOS 15.1
• 操作：安装MetaboAnalystR时需编译Cpp文件，已完成gfortran安装
• 异常：运行Rcpp::sourceCpp("./helloworld.cpp")时出现链接错误，R在查找/opt/gfortran/lib路径，但实际gfortran位于/usr/local/bin/gfortran

错误信息如下：

using C++ compiler: ‘Apple clang version 16.0.0 (clang-1600.0.26.4)’
using SDK: ‘MacOSX15.1.sdk’
clang++ -arch arm64 -std=gnu17 -I"/Library/Frameworks/R.framework/Resources/include" -DNDEBUG -I../inst/include -I"/Library/Frameworks/R.framework/Versions/4.4-arm64/Resources/library/Rcpp/include" -I"/Library/Frameworks/R.framework/Versions/4.4-arm64/Resources/library/RcppArmadillo/include" -I"/Users/caoxiaomai/Desktop/Metabonomic/Metabonomic" -I/opt/R/arm64/include -fPIC -falign-functions=64 -Wall -g -O2 -c helloworld.cpp -o helloworld.o
clang -arch arm64 -std=gnu17 -dynamiclib -Wl,-headerpad_max_install_names -undefined dynamic_lookup -L/Library/Frameworks/R.framework/Resources/lib -L/opt/R/arm64/lib -o sourceCpp_2.so helloworld.o -L/Library/Frameworks/R.framework/Resources/lib -lRlapack -L/Library/Frameworks/R.framework/Resources/lib -lRblas -L/opt/gfortran/lib/gcc/aarch64-apple-darwin20.0/12.2.0 -L/opt/gfortran/lib -lgfortran -lemutls_w -lquadmath -F/Library/Frameworks/R/framework/.. -framework R -Wl,-framework -Wl,CoreFoundation
ld: warning: search path '/opt/gfortran/lib/gcc/aarch64-apple-darwin20.0/12.2.0' not found
ld: warning: search path '/opt/gfortran/lib' not found
ld: library 'gfortran' not found
clang: error: linker command failed with exit code 1 (use -v to see invocation)
make: *** [sourceCpp_2.so] Error 1
Error in Rcpp::sourceCpp("./helloworld.cpp") : Error 1 occurred building shared library.

解决步骤 #

1. 定位gfortran的库文件路径 #

在终端执行以下命令，获取gfortran的库搜索目录：

gfortran -print-search-dirs

找到输出中libraries:开头的行，提取实际的lib路径，例如/usr/local/lib/gcc/aarch64-apple-darwin24/14.0.6/（路径根据你的安装版本可能不同）。

2. 创建符号链接匹配R的期望路径 #

R默认在/opt/gfortran下查找库，通过符号链接将实际路径映射到该位置：

sudo mkdir -p /opt/gfortran/lib
# 替换下面的路径为你第一步查到的实际库路径
sudo ln -s /usr/local/lib/gcc/aarch64-apple-darwin24/14.0.6 /opt/gfortran/lib/gcc/aarch64-apple-darwin20.0/12.2.0
sudo ln -s /usr/local/lib/libgfortran.dylib /opt/gfortran/lib/libgfortran.dylib
sudo ln -s /usr/local/lib/libquadmath.dylib /opt/gfortran/lib/libquadmath.dylib

3. 配置R的编译环境变量 #

临时设置环境变量让R识别正确的库路径：

# 替换路径为你查到的实际lib路径
export LDFLAGS="-L/usr/local/lib/gcc/aarch64-apple-darwin24/14.0.6 -L/usr/local/lib"
export CPPFLAGS="-I/usr/local/include"

如果需要永久生效，将上述两行添加到~/.zshrc（zsh终端）或~/.bash_profile（bash终端），然后执行source ~/.zshrc或source ~/.bash_profile使设置生效。

4. 重新测试并安装MetaboAnalystR #

打开R或RStudio，重新测试Cpp编译：

Rcpp::sourceCpp("./helloworld.cpp")

编译成功后，安装MetaboAnalystR：

install.packages("MetaboAnalystR", dependencies = TRUE)

备选方案：使用conda管理环境 #

如果上述方法无效，可通过conda搭建独立环境：

1. 安装miniconda或anaconda
2. 创建并激活环境：

conda create -n r-metabo r-base r-rcpp r-rcpparmadillo gfortran_osx-64
conda activate r-metabo

3. 在激活的环境中启动R，安装MetaboAnalystR即可。

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