使用Conan时Zstandard库链接错误排查求助

我觉得自己漏了某个简单的点，以下是环境配置及遇到的问题：

我用Conan安装Zstandard库，conanfile配置如下：

[requires]
...
zstd/1.5.1

配置参数：

[settings]
os=Linux
arch=x86_64
build_type=Release
compiler=clang
compiler.version=12
compiler.libcxx=libstdc++

[env]
CC=/usr/bin/clang-12
CXX=/usr/bin/clang++-12

我的CMakeLists.txt内容如下：

set(LIBRARY_ZSTDSTREAM_SOURCES
    zstdstream.cpp
)

set(LIBRARY_ZSTDSTREAM_HEADERS
    circularbuffer.h
    zstdstream.h
)

add_library(${LIBRARY_ZSTDSTREAM_NAME} STATIC
    ${LIBRARY_ZSTDSTREAM_SOURCES}
    ${LIBRARY_ZSTDSTREAM_HEADERS})

target_link_libraries(${LIBRARY_ZSTDSTREAM_NAME} PUBLIC
    ${CONAN_ZSTD}
    ${LIBRARY_FORMAT_NAME}
)

target_include_directories(${LIBRARY_ZSTDSTREAM_NAME} PUBLIC
    "./"
    "${CMAKE_BINARY_DIR}/configured_files/include"
)

编译时出现链接错误：

zstdstream.cpp:(.text+0x3b): undefined reference to `ZSTD_getErrorName'
/usr/bin/ld: ../../lib/libzstdstream.a(zstdstream.cpp.o): in function `common::zstdstream::cstream::cstream()':
zstdstream.cpp:(.text+0xc5): undefined reference to `ZSTD_createCStream'
/usr/bin/ld: ../../lib/libzstdstream.a(zstdstream.cpp.o): in function `common::zstdstream::cstream::~cstream()':
zstdstream.cpp:(.text+0xd8): undefined reference to `ZSTD_freeCStream'
/usr/bin/ld: zstdstream.cpp:(.text+0xe3): undefined reference to `ZSTD_isError'
/usr/bin/ld: ../../lib/libzstdstream.a(zstdstream.cpp.o): in function `common::zstdstream::cstream::init(int)':
zstdstream.cpp:(.text+0x148): undefined reference to `ZSTD_initCStream'
/usr/bin/ld: zstdstream.cpp:(.text+0x153): undefined reference to `ZSTD_isError'

我设置VERBOSE=1运行Makefile检查链接器，确认已添加zstd库路径：

-Wl,-rpath,/home/worker/.conan/data/zstd/1.5.1/_/_/package/4d1e52cb9a38d07b5e682edec92bb71d7afcd534/lib:

-L/home/worker/.conan/data/zstd/1.5.1/_/_/package/4d1e52cb9a38d07b5e682edec92bb71d7afcd534/lib

确认zstd库存在且路径配置正确，但仍出现链接错误，求解决办法。

1. 修复Conan变量的CMake集成 #

当前使用${CONAN_ZSTD}链接库，若未正确导入Conan生成的CMake变量，该变量可能为空或不完整。改用Conan官方推荐的集成方式：

• 在CMakeLists.txt开头添加：

  include(${CMAKE_BINARY_DIR}/conanbuildinfo.cmake)
  conan_basic_setup()
  

• 链接时替换为标准的Conan包引用：

  target_link_libraries(${LIBRARY_ZSTDSTREAM_NAME} PUBLIC
      CONAN_PKG::zstd
      ${LIBRARY_FORMAT_NAME}
  )
  

  若使用Conan 2.x，则直接用zstd::zstd替代CONAN_PKG::zstd。

2. 检查zstd库是否包含流API符号 #

你调用的是ZSTD压缩流相关API，部分Conan的zstd包可能默认未编译流模块。可通过以下命令验证库中是否包含目标符号：

nm -D /home/worker/.conan/data/zstd/1.5.1/_/_/package/4d1e52cb9a38d07b5e682edec92bb71d7afcd534/lib/libzstd.so | grep ZSTD_createCStream

若无输出，说明包缺少对应符号，需重新安装zstd并指定编译选项：

# 在conanfile中添加
[options]
zstd:shared=True
zstd:with_zstdcpp=True

3. 调整链接顺序 #

链接器的库顺序会影响符号解析，确保依赖zstd的目标排在zstd库之前：

target_link_libraries(${LIBRARY_ZSTDSTREAM_NAME} PUBLIC
    ${LIBRARY_FORMAT_NAME}
    CONAN_PKG::zstd
)

4. 确认编译器ABI匹配 #

你设置了compiler.libcxx=libstdc++，但clang-12默认可能使用libc++，需确保Conan安装zstd时的libcxx与项目一致。可重新安装包并明确指定：

conan install . -s compiler.libcxx=libstdc++11

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