如何将Conda环境中安装的库通过CMake链接到C++程序？

我需要把jsoncpp、rapidxml这类库链接到运行在服务器上的C++代码中，服务器用Anaconda虚拟环境隔离环境，因此必须将这些库安装到虚拟环境里，让代码从虚拟环境路径而非全局路径查找依赖。我能用CMake动态链接普通外部安装的库，但始终无法正确链接Conda环境内的库。

我试过的操作：

• 执行 cmake .. -DCMAKE_PREFIX_PATH=$CONDA_PREFIX
• 在CMakeLists.txt中设置：

  SET(CMAKE_PREFIX_PATH /home/XXX/anaconda3/envs/envname)
  

• 之后使用两种链接方式：
  方式一：

  target_link_libraries(mycode jsoncpp)
  

  方式二：

  find_package(PkgConfig REQUIRED)
  pkg_check_modules(JSONCPP jsoncpp)
  target_link_libraries(mycode ${JSONCPP_LIBRARIES})
  

• 也试过完全不配置上述内容

补充说明：CMake为单独安装，未放入Conda环境，仅在激活虚拟环境后运行make命令。

遇到的错误：

• 不配置链接语句时，CMake报大量类似 undefined reference to Json::Value::~Value()'` 的未定义引用错误
• 配置后，在另一台机器的已安装jsoncpp的Conda环境中运行二进制文件，报错 error while loading shared libraries: libjsoncpp.so.1: cannot open shared object file: No such file or directory，推测链接的是全局版本而非Conda环境内的库。

1. 确保Conda环境变量被正确识别 #

激活虚拟环境后，先验证环境路径和库路径是否正确：

echo $CONDA_PREFIX
echo $LD_LIBRARY_PATH

如果LD_LIBRARY_PATH中没有$CONDA_PREFIX/lib，可临时添加：

export LD_LIBRARY_PATH=$CONDA_PREFIX/lib:$LD_LIBRARY_PATH

也可通过创建脚本永久添加，避免每次激活环境都手动设置：

mkdir -p $CONDA_PREFIX/etc/conda/activate.d
echo 'export LD_LIBRARY_PATH=$CONDA_PREFIX/lib:$LD_LIBRARY_PATH' > $CONDA_PREFIX/etc/conda/activate.d/env_vars.sh

2. 调整CMake配置，强制优先查找Conda环境路径 #

在CMakeLists.txt开头加入以下配置，让CMake优先从Conda环境查找依赖，跳过全局路径：

# 用环境变量获取Conda路径，避免硬编码
set(CMAKE_PREFIX_PATH "$ENV{CONDA_PREFIX}" ${CMAKE_PREFIX_PATH})
# 限制CMake仅在指定路径查找依赖
set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)

# 查找并链接jsoncpp（Conda安装的库会自带CMake配置文件）
find_package(jsoncpp REQUIRED)
target_link_libraries(mycode PRIVATE jsoncpp_lib)

# 处理rapidxml（若通过Conda安装）
find_package(rapidxml REQUIRED)
target_include_directories(mycode PRIVATE ${RAPIDXML_INCLUDE_DIRS})

3. 设置RPATH确保运行时找到Conda库 #

为避免运行时找不到库，在CMake中配置RPATH，让二进制文件记住Conda库的路径：

# 指定运行时优先查找的Conda库路径
set(CMAKE_INSTALL_RPATH "$ENV{CONDA_PREFIX}/lib")
# 确保安装后RPATH依然生效
set(CMAKE_INSTALL_RPATH_USE_LINK_PATH TRUE)

4. 验证链接结果 #

编译完成后，用ldd命令检查二进制文件的依赖路径：

ldd ./mycode | grep jsoncpp

若输出路径包含$CONDA_PREFIX/lib，说明链接正确；若为全局路径（如/usr/lib），需重新检查CMake配置和环境变量。

额外注意事项 #

• 不要硬编码Conda环境的绝对路径，使用$ENV{CONDA_PREFIX}适配不同机器环境
• 确认Conda环境内已安装目标库：conda list | grep jsoncpp，未安装则执行conda install jsoncpp rapidxml
• 若CMake仍找不到库，可手动指定头文件和库路径：

  target_include_directories(mycode PRIVATE "$ENV{CONDA_PREFIX}/include")
  target_link_directories(mycode PRIVATE "$ENV{CONDA_PREFIX}/lib")
  target_link_libraries(mycode PRIVATE jsoncpp)
  

内容的提问来源于stack exchange，提问作者oliver.c