CMake链接共享库时调用系统版本而非项目内置LibUsb问题排查

你的问题其实是动态链接器运行时路径搜索的典型场景——虽然你链接阶段指定了自己的libusb-1.0.so，但运行时动态链接器默认会优先搜索系统标准库目录，而你的内置库目录不在默认搜索路径里。另外关于libusb-1.0.so.0的疑问：这是共享库的SONAME字段决定的，libusb-1.0.so通常是指向libusb-1.0.so.0的符号链接（或者库文件内部的SONAME就是这个带版本号的名字），所以可执行文件的NEEDED条目会记录这个SONAME，这是正常行为，问题核心还是路径搜索优先级的问题。

用CMake配置RPATH就能完美解决，下面是具体步骤：

一、理解RPATH的作用 #

RPATH是嵌入在可执行文件/共享库中的一组路径，运行时动态链接器会优先在这些路径中查找依赖库，之后才会去系统默认目录搜索。我们只需要把你的内置LibUsb所在的${OUTPUT_BIN_DIR}目录加入可执行文件的RPATH即可。

二、CMake配置方案 #

全局配置（作用于整个项目） #

在项目根目录的CMakeLists.txt开头添加以下配置：

# 禁用跳过构建时的RPATH
set(CMAKE_SKIP_BUILD_RPATH OFF)
# 构建阶段就使用安装时的RPATH配置（避免构建后运行还要手动设置LD_LIBRARY_PATH）
set(CMAKE_BUILD_WITH_INSTALL_RPATH ON)
# 设置RPATH为你的内置LibUsb所在目录
set(CMAKE_INSTALL_RPATH "${OUTPUT_BIN_DIR}")
# 自动将链接时用到的库路径加入RPATH（可选，但能简化配置）
set(CMAKE_RPATH_USE_LINK_PATH ON)

针对单个目标配置（更精准） #

如果你只想给${TARGET_NAME}这个可执行文件设置RPATH，也可以单独为目标配置：

target_link_libraries(${TARGET_NAME} ... LibUsb)

# 为目标设置RPATH属性
set_target_properties(${TARGET_NAME} PROPERTIES
    # 指定运行时搜索路径为你的内置LibUsb目录
    INSTALL_RPATH "${OUTPUT_BIN_DIR}"
    # 构建时就启用该RPATH
    BUILD_WITH_INSTALL_RPATH ON
)

三、验证配置是否生效 #

重新编译项目后，用以下命令验证：

1. 检查可执行文件的RPATH是否包含目标目录：

readelf -d Build/Linux-Debug/Output/Bin/myexe | grep RPATH

输出应该能看到${OUTPUT_BIN_DIR}的路径（比如/mnt/c/x/Build/Linux-Debug/Output/Bin）。

2. 检查动态链接库的搜索结果：

ldd Build/Linux-Debug/Output/Bin/myexe

此时libusb-1.0.so.0应该指向你内置的路径，而不是系统的/lib/x86_64-linux-gnu/目录。

额外说明 #

• 如果你是自己编译内置LibUsb，确保编译LibUsb时也正确设置了RPATH（可选，但能避免库自身的依赖问题）。
• 若你想彻底避免系统库干扰，也可以考虑将LibUsb编译为静态库（修改find_library找静态库文件，比如libusb-1.0.a），但静态库会增加可执行文件体积，且无法动态更新。

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