Conda环境编译C++代码出现x86_64架构未定义符号与运行库加载错误

问题根因说明 #

第一阶段链接报错原因 #

初始编译命令仅通过-I参数指定了GSL头文件的搜索路径，没有声明链接GSL库的相关参数，链接器无法找到GSL函数的实现，因此报未定义符号错误。你后续添加-L"${CONDA_PREFIX}/lib" -lgsl参数后编译成功，就是解决了链接库缺失的问题。

第二阶段运行时报错原因 #

编译时没有指定动态库的运行时搜索路径（rpath），macOS系统加载可执行文件时只会扫描默认系统库路径，找不到存放在conda环境目录内的libgsl.23.dylib，因此触发dyld加载失败报错。

解决方案 #

方案1：临时生效（仅当前终端会话可用） #

激活对应conda环境后，先执行以下命令将conda的库路径加入动态库搜索列表：

export DYLD_LIBRARY_PATH="${CONDA_PREFIX}/lib":$DYLD_LIBRARY_PATH

之后再运行./a.out即可正常启动。

方案2：编译时嵌入rpath（一劳永逸，推荐） #

编译时添加参数将conda库路径直接写入可执行文件的运行时搜索规则中，编译命令如下：

clang++ -Wall parallel_MCMC_newMHratio.cpp -o a.out -I"${CONDA_PREFIX}/include" -L"${CONDA_PREFIX}/lib" -lgsl -Wl,-rpath,"${CONDA_PREFIX}/lib"

该方式编译出的可执行文件每次运行都能自动定位到conda环境内的GSL库，无需修改环境变量。

注意事项 #

如果你的代码用到了GSL的数值计算相关功能，还需要额外链接GSL配套的CBLAS库，在编译命令末尾添加-lgslcblas即可避免出现新的未定义符号错误。

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