Windows下如何用静态库构建无外部依赖的独立DLL？

Windows下的.lib文件很容易让人混淆——它可能是DLL导入库（对应动态链接的.dll），也可能是真正的静态库。你遇到的LNK2019/2001错误，大概率是因为链接的不是真正的静态库，或者静态库的编译配置和你的DLL不匹配。下面是一步步的解决方案：

第一步：确保依赖库是真正的静态库 #

首先要确认你的depA是作为静态库构建的，而不是动态库的导入库：

• 在构建depA时，明确指定静态库类型：

  add_library(depA STATIC ${depA_sources})
  

  或者全局禁用动态库构建：

  set(BUILD_SHARED_LIBS OFF)
  

• 检查depA的代码符号：如果depA原本是为动态库写的，可能会有__declspec(dllimport)标记，这会导致静态链接时符号无法被正确解析。建议用宏来控制符号声明：

  #ifdef BUILD_SHARED_LIBS
  #define DEPA_API __declspec(dllexport)
  #else
  #define DEPA_API
  #endif
  
  // 用DEPA_API标记depA的公开函数/类
  DEPA_API void depA_function();
  

  这样静态编译时，符号不会被当作导入，而是直接嵌入到静态库中。

第二步：用CMake正确链接静态库到DLL #

不需要手动指定.lib的绝对路径，CMake可以帮你自动处理依赖：

• 如果depA是同一个项目里的目标，直接用目标名链接：

  add_library(dll_target SHARED ${sources})
  target_link_libraries(dll_target PRIVATE depA)
  

• 如果depA是外部预编译的静态库，要确保CMake识别它是静态库：

  add_library(depA STATIC IMPORTED)
  set_target_properties(depA PROPERTIES IMPORTED_LOCATION "C:/path/to/depA.lib")
  target_include_directories(depA INTERFACE "C:/path/to/depA/include")
  target_link_libraries(dll_target PRIVATE depA)
  

  可以用dumpbin /headers depA.lib验证：输出里如果显示static library就是真正的静态库，DLL import library则是导入库，不能用来构建无依赖的DLL。

第三步：解决LNK错误的常见坑 #

1. 编译选项不匹配 #

Windows下CRT（C运行时库）的链接方式必须一致：如果静态库用/MT（多线程静态）编译，你的DLL也必须用/MT，否则会出现链接冲突。统一设置的方式：

# 全局设置静态链接CRT
set(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /MT")
set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} /MTd")

或者针对单个目标设置：

target_compile_options(depA PRIVATE $<$<CONFIG:Release>:/MT> $<$<CONFIG:Debug>:/MTd>)
target_compile_options(dll_target PRIVATE $<$<CONFIG:Release>:/MT> $<$<CONFIG:Debug>:/MTd>)

2. 符号导出问题 #

你的DLL需要导出自己的符号（如果要被其他程序调用），但依赖的静态库不需要导出符号——只要它们的符号能被链接到DLL中即可。比如DLL的导出宏：

#ifdef DLL_TARGET_EXPORTS
#define DLL_TARGET_API __declspec(dllexport)
#else
#define DLL_TARGET_API __declspec(dllimport)
#endif

extern "C" DLL_TARGET_API void my_dll_entry() {
    depA_function(); // 直接调用静态库的函数
}

记得在CMake中给DLL目标添加定义：

target_compile_definitions(dll_target PRIVATE DLL_TARGET_EXPORTS)

3. 遗漏间接依赖 #

如果depA还依赖其他库，那些库也必须是静态库，并且被正确链接到你的DLL中。比如depA依赖depB静态库，要确保depB也被添加到链接链里：

target_link_libraries(depA PRIVATE depB)
target_link_libraries(dll_target PRIVATE depA)

验证结果 #

构建完成后，用dumpbin /dependents dll_target.dll检查依赖：如果只有系统级DLL（如kernel32.dll、user32.dll），说明你的DLL已经是无外部依赖的独立文件了。

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