使用CMake调用Windows库时出现“undefined symbol: __declspec(dllimport)”错误

我正在将现有Linux应用迁移到Windows，使用CLion+CMake搭建环境，需要调用一个仅提供.h、.dll和.lib的黑盒第三方库（Linux版本的.so和.h集成正常）。

代码结构 #

test/
├─ sdk/
│  ├─ include/
│  │  ├─ netsdk.h
│  ├─ lib/
│  │  ├─ kdnetsdk.dll
│  │  ├─ kdnetsdk.lib
├─ CMakeLists.txt
├─ main.cpp

核心代码 #

main.cpp #

#include "netsdk.h"

int main()
{
    int ret = NET_Init();
    return ret;
}

CMakeLists.txt #

cmake_minimum_required(VERSION 3.27)
project(test)

set(CMAKE_CXX_STANDARD 17)

add_executable(test main.cpp)

add_library(sdk SHARED IMPORTED)
set_property(TARGET sdk PROPERTY
        IMPORTED_LOCATION "${PROJECT_SOURCE_DIR}/sdk/lib/kdnetsdk.dll")
set_property(TARGET sdk PROPERTY
        IMPORTED_IMPLIB "${PROJECT_SOURCE_DIR}/sdk/lib/kdnetsdk.lib")
set_property(TARGET sdk PROPERTY
        INTERFACE_INCLUDE_DIRECTORIES $<INSTALL_INTERFACE:sdk/include>)

target_include_directories(test PUBLIC
        "${PROJECT_SOURCE_DIR}/sdk/include"
)

target_link_libraries(test PRIVATE sdk)

链接错误信息 #

[2/2] Linking CXX executable test.exe
FAILED: test.exe 
cmd.exe /C "cd . && "C:\Users\glamd\AppData\Local\Programs\CLion Nova\bin\cmake\win\x64\bin\cmake.exe" -E vs_link_exe --intdir=CMakeFiles\test.dir --rc=C:\PROGRA~2\WI3CF2~1\10\bin\100226~1.0\x64\rc.exe --mt=C:\PROGRA~2\WI3CF2~1\10\bin\100226~1.0\x64\mt.exe --manifests  -- C:\PROGRA~1\MICROS~2\2022\COMMUN~1\VC\Tools\Llvm\x64\bin\lld-link.exe /nologo CMakeFiles\test.dir\main.cpp.obj  /out:test.exe /implib:test.lib /pdb:test.pdb /version:0.0 /machine:x64 /debug /INCREMENTAL /subsystem:console  D:\test\sdk\lib\kdnetsdk.lib  kernel32.lib user32.lib gdi32.lib winspool.lib shell32.lib ole32.lib oleaut32.lib uuid.lib comdlg32.lib advapi32.lib && cd ."
LINK Pass 1: command "C:\PROGRA~1\MICROS~2\2022\COMMUN~1\VC\Tools\Llvm\x64\bin\lld-link.exe /nologo CMakeFiles\test.dir\main.cpp.obj /out:test.exe /implib:test.lib /pdb:test.pdb /version:0.0 /machine:x64 /debug /INCREMENTAL /subsystem:console D:\test\sdk\lib\kdnetsdk.lib kernel32.lib user32.lib gdi32.lib winspool.lib shell32.lib ole32.lib oleaut32.lib uuid.lib comdlg32.lib advapi32.lib /MANIFEST /MANIFESTFILE:CMakeFiles\test.dir/intermediate.manifest CMakeFiles\test.dir/manifest.res" failed (exit code 1) with the following output:
lld-link: error: undefined symbol: __declspec(dllimport) NET_Init
>>> referenced by D:\test\main.cpp:6
>>>               CMakeFiles\test.dir\main.cpp.obj:(main)
ninja: build stopped: subcommand failed.

第三方库头文件（netsdk.h）关键片段 #

#ifdef __cplusplus
extern "C" {
#endif

...

#ifdef WIN32
    #ifdef _NETSDK_
        #define NVR_API __declspec(dllexport)
    #else
        #define NVR_API __declspec(dllimport)
    #endif
    #define STDCALL _stdcall
#else
    #define NVR_API
    #define STDCALL
#endif

...

NVR_API s32 STDCALL NET_Init();

无论使用MinGW还是Visual Studio工具链，均出现上述链接错误，请问需要哪些特定Windows配置？

1. 确保WIN32宏正确定义 #

头文件中STDCALL（即_stdcall调用约定）和__declspec(dllimport)的生效依赖WIN32宏。部分工具链（如MinGW）不会自动定义该宏，导致调用约定不匹配，函数名修饰错误。

在CMake中添加编译定义：

target_compile_definitions(test PRIVATE WIN32)

2. 验证库文件与项目架构匹配 #

链接器找不到符号的常见原因是架构不兼容（比如项目编译x64，但第三方库是x86版本）。

• 使用VS自带的dumpbin工具检查库架构：

  dumpbin /headers D:\test\sdk\lib\kdnetsdk.lib
  

  查看输出中的machine字段：x86-64对应x64，80386对应x86。确保与项目编译架构一致（CLion中可在Settings -> Build, Execution, Deployment -> Toolchains中设置）。

3. 修正导入库的INCLUDE路径配置 #

原CMake中INTERFACE_INCLUDE_DIRECTORIES使用了$<INSTALL_INTERFACE:sdk/include>，这是安装阶段的路径，开发阶段应使用构建路径：

set_property(TARGET sdk PROPERTY
        INTERFACE_INCLUDE_DIRECTORIES "${PROJECT_SOURCE_DIR}/sdk/include")

（或者保留原target_include_directories配置，二者选其一即可）

4. 检查s32类型定义 #

头文件中s32必须是有效的32位整数类型，否则会导致函数签名不匹配。如果头文件未定义s32，需手动添加：

// 在main.cpp开头添加
typedef int s32;

或者在CMake中添加：

target_compile_definitions(test PRIVATE s32=int)

5. MinGW工具链特殊处理 #

如果使用MinGW链接VS编译的第三方库，stdcall函数名修饰规则存在差异：

• VS会将NET_Init修饰为_NET_Init@0
• MinGW默认会查找@NET_Init@0

可以通过以下方式解决：

• 在CMake中添加链接器选项，强制MinGW使用VS风格的修饰：

  target_link_options(test PRIVATE -Wl,--add-stdcall-alias)
  

• 或者使用MinGW的dlltool工具从DLL生成兼容的导入库：

  dlltool -k -d netsdk.def -l kdnetsdk_mingw.lib
  

  （需要先编写netsdk.def文件，列出所有需要导出的函数名）

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