CMake如何导出find_package获取的导入库并设置命名空间别名？

错误原因 #

CMake 存在原生限制：EXPORT_NAME 属性用于配置目标导出时的对外名称，仅支持当前项目内创建的普通目标（包括 STATIC/SHARED/INTERFACE 类型），不支持 IMPORTED 导入目标，因此你给导入目标设置该属性会直接触发报错。

可行解决方案 #

最常用的方案是通过自定义 INTERFACE 桥接目标中转，既可以保留导入目标的所有属性，也能正常导出命名空间别名，示例代码如下：

set(mylib_DIR ${lib_install_dir})
find_package(my_lib 3.5.2 CONFIG REQUIRED)
set(my_lib mylibname)

# 导入第三方库，这部分逻辑保持不变
add_library(${my_lib}_imp SHARED IMPORTED)
set_property(TARGET ${my_lib}_imp PROPERTY
    IMPORTED_LOCATION ${library_dir})
target_include_directories(${my_lib}_imp INTERFACE ${include_dir})

# 新增：创建当前项目的INTERFACE桥接目标，可正常配置导出属性
add_library(${my_lib}_wrap INTERFACE)
target_link_libraries(${my_lib}_wrap INTERFACE ${my_lib}_imp)

# 别名和导出属性都挂在桥接目标上，不会触发报错
add_library(myns::${my_lib} ALIAS ${my_lib}_wrap)
set_property(TARGET ${my_lib}_wrap PROPERTY EXPORT_NAME myns::${my_lib})

# 后续导出你自己项目的目标时，把桥接目标也加入导出列表即可
install(TARGETS ${my_lib}_wrap
        EXPORT <你的项目导出目标名>
        COMPONENT runtime)

如果不需要单独保留导入目标，也可以简化写法，直接把第三方库的路径和头文件挂到INTERFACE目标上：

find_package(my_lib 3.5.2 CONFIG REQUIRED)
set(my_lib mylibname)

add_library(${my_lib}_wrap INTERFACE)
target_include_directories(${my_lib}_wrap INTERFACE ${include_dir})
target_link_libraries(${my_lib}_wrap INTERFACE ${library_dir})

add_library(myns::${my_lib} ALIAS ${my_lib}_wrap)
set_property(TARGET ${my_lib}_wrap PROPERTY EXPORT_NAME myns::${my_lib})

注意事项 #

• 如果使用多配置生成器（如 Visual Studio、Xcode），需要按配置分别设置导入库的路径：IMPORTED_LOCATION_DEBUG、IMPORTED_LOCATION_RELEASE，避免链接错库版本。
• 如果第三方库存在额外依赖（如系统库、其他第三方依赖），需要同步添加到INTERFACE目标的INTERFACE_LINK_LIBRARIES中，下游使用时会自动继承依赖。

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