CMake：如何在传递依赖中正确使用带版本号的导入libft4222.so.1.2.3

问题根因 #

你遇到的报错本质是由库本身的SONAME属性导致的：你使用的libft4222.so.1.2.3内置SONAME为libft4222.so，当你将它链接到项目内的共享库A时，共享库A的依赖段（NEEDED）会直接记录SONAME的值libft4222.so，而非你实际使用的带版本后缀的文件名。后续链接依赖共享库A的可执行文件时，链接器会优先查找名为libft4222.so的文件，找不到就抛出你看到的报错。
直接将libft4222添加为可执行文件依赖时可以正常编译，是因为此时链接器会直接传入完整的库路径，不需要经过中间共享库的依赖查找步骤。

解决方案（无需创建软链接） #

方案1：为导入目标添加IMPORTED_NO_SONAME属性 #

这是最符合CMake规范的解决方案，不需要修改库文件，也不需要额外创建软链接。该属性会告诉CMake不要使用导入库的SONAME字段，链接时直接使用完整的库文件名写入依赖段。
修改你的FindLibFT4222.cmake配置如下：

if (LIBFT4222_FOUND)
    if (NOT TARGET LibFT4222::LibFT4222)
        add_library(LibFT4222::LibFT4222 UNKNOWN IMPORTED)
        set_target_properties(LibFT4222::LibFT4222
            PROPERTIES 
                IMPORTED_LOCATION ${LibFT4222_LIBS}
                IMPORTED_NO_SONAME TRUE # 新增该行配置
        )
        target_include_directories(LibFT4222::LibFT4222
            INTERFACE
                ${LibFT4222_INCLUDE_DIR})
    endif()
endif()

修改后重新编译，共享库A的依赖段会直接记录libft4222.so.1.2.3，后续链接可执行文件、运行程序时都会直接查找带版本后缀的库，不会再要求libft4222.so软链接。

方案2：为链接器指定搜索路径 #

如果不方便修改导入目标的属性，可以在链接可执行文件时添加-rpath-link参数，指定libft4222.so.1.2.3所在的目录，让链接器可以找到对应库：

# 替换为你实际的库所在目录
set(LIBFT4222_LIB_DIR /path/to/directory/of/libft4222/)
target_link_options(your_executable_target PRIVATE -Wl,-rpath-link=${LIBFT4222_LIB_DIR})

注意该方案仅解决编译链接阶段的报错，程序运行时动态加载器仍会查找libft4222.so，需要额外配置运行时rpath或者创建软链接。

方案3：直接指定完整库名链接 #

你也可以不使用导入目标，直接通过-l:语法指定完整的库文件名进行链接，链接器会直接查找对应文件名的库，不需要不带版本的软链接：

target_link_libraries(your_shared_lib_A PRIVATE -L/path/to/directory/of/libft4222/ -l:libft4222.so.1.2.3)

可选方案：创建软链接 #

如果你的项目需要兼容常规的库加载逻辑，创建软链接仍是通用性最高的方案。如果没有权限修改系统库目录，可以在项目构建目录下创建软链接，再将构建目录加入链接搜索路径即可：

ln -s /path/to/libft4222.so.1.2.3 ${PROJECT_BINARY_DIR}/libft4222.so

然后在CMake中添加搜索路径：

link_directories(${PROJECT_BINARY_DIR})

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