CMake如何将外部共享库（DLL）引入静态库项目？

我帮你分析下当前遇到的问题，然后给出具体的解决步骤：

首先，你之前碰到的两个问题根源分别是：

• find_package只链接静态库：大概率是因为ext1的CMake配置文件（比如ext1Config.cmake）默认优先选择静态库，或者没有正确暴露动态库的目标。
• 直接用link_directories(${ext1_DIR}/lib/a.dll)报错：这个用法本身就错了，link_directories是用来指定库文件的搜索目录，不是直接指定DLL文件路径。CMake会把你传入的DLL当作静态库去解析，自然会提示“损坏的DLL文件”。

接下来是具体的解决方法，分两种情况处理：

情况1：ext1提供了正确的CMake配置文件（推荐） #

如果ext1的包是标准的CMake包（有ext1Config.cmake），别再手动用include_directories和link_directories了，直接用CMake的目标链接机制：

1. 先确保你要链接动态库，而不是静态库。可以在find_package之前设置：

   # 优先使用动态库（如果ext1支持的话）
   set(BUILD_SHARED_LIBS ON)
   # 或者有些库会提供专门的选项，比如：
   # set(ext1_USE_STATIC_LIBS OFF CACHE BOOL "Use static libraries of ext1" FORCE)
   

2. 然后用target_link_libraries直接链接ext1的目标：

   find_package(ext1 3.1.2 REQUIRED)
   # 替换成你的项目目标名称
   target_link_libraries(your_project_name PRIVATE ext1::ext1)
   

   这种方式下，CMake会自动处理头文件包含、库文件链接，以及部分运行时DLL的依赖问题（部分库会自动处理DLL复制，若没有则需要自己加步骤）。

情况2：ext1没有提供CMake配置文件，需要手动配置 #

如果ext1是没有CMake支持的第三方库，按以下步骤来：

1. 指定头文件目录：

   target_include_directories(your_project_name PRIVATE ${ext1_DIR}/include)
   

   用target_include_directories代替全局的include_directories，更符合现代CMake的最佳实践。

2. 找到对应的导入库：
   在Windows上，链接DLL需要用到导入库（.lib文件），而不是直接链接DLL。你需要在ext1的lib目录里找到和DLL对应的.lib文件（比如a.dll对应的a.lib是导入库，a_static.lib可能是静态库）。用find_library定位它：

   find_library(EXT1_IMPORTED_LIB
                NAMES a.lib  # 替换成实际的导入库名称
                PATHS ${ext1_DIR}/lib
                REQUIRED)
   

3. 链接导入库：

   target_link_libraries(your_project_name PRIVATE ${EXT1_IMPORTED_LIB})
   

4. 确保运行时能找到DLL：
   链接完成后，DLL需要放在可执行文件的同一目录，或者系统路径里。可以用add_custom_command在构建完成后自动复制DLL到输出目录：

   add_custom_command(TARGET your_project_name POST_BUILD
                      COMMAND ${CMAKE_COMMAND} -E copy_if_different
                      "${ext1_DIR}/lib/a.dll"  # 源DLL路径
                      $<TARGET_FILE_DIR:your_project_name>)  # 目标目录（可执行文件所在目录）
   

额外排查点 #

如果还是遇到DLL相关的错误，检查以下几点：

• 架构匹配：你的项目是x86还是x64？ext1的DLL必须和项目架构一致，否则会提示损坏或无法加载。
• 编译器版本：ext1的DLL如果是用不同版本的MSVC编译的，可能会有兼容性问题，尽量用同版本编译器编译的库。
• DLL依赖：ext1的DLL可能还依赖其他第三方DLL，可以用dumpbin /dependents a.dll（Windows SDK工具）查看依赖，确保这些依赖也能被找到。

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