VC 編譯錯誤 C2491：definition of dllimport function not allowed 解決方案

錯誤信息

error C2491: 'YourFunction' : definition of dllimport function not allowed
// 中文：不允許 dllimport 函數的定義

根因：聲明與定義的屬性衝突

在 DLL 導出頭文件中，同一函數被標記為 __declspec(dllimport)（導入），但在實現文件（.cpp）中又給出了函數體定義。編譯器發現：你既說「這函數從別的 DLL 導入」，又在當前模組定義了它——邏輯矛盾。

典型錯誤場景

// MyDLL.h - 共享頭文件
#ifdef MYDLL_EXPORTS
#define MYDLL_API __declspec(dllexport)
#else
#define MYDLL_API __declspec(dllimport)  // 客戶端引入時定義為導入
#endif

MYDLL_API void Foo();  // 聲明

// MyDLL.cpp - 實現文件
#include "MyDLL.h"
MYDLL_API void Foo() { ... }  // 定義：此處 MYDLL_EXPORTS 應已定義，展開為 dllexport

問題出在：實現文件 未定義 MYDLL_EXPORTS，導致宏展開為 dllimport，隨後出現函數定義 → C2491。

解決方案

方法一：確保 DLL 專案定義導出宏（標準做法）

1. DLL 專案 → 屬性 → C/C++ → 預處理器 → 預處理器定義 → 添加 MYDLL_EXPORTS
2. 或在 DLL 專案的 stdafx.h / 專用頭文件最頂部強制定義：
   #define MYDLL_EXPORTS

方法二：實現文件單獨強制導出（快速修復）

// MyDLL.cpp
#define MYDLL_EXPORTS  // 必須在包含頭文件之前！
#include "MyDLL.h"

MYDLL_API void Foo() { ... }  // 此處展開為 __declspec(dllexport)

方法三：分離導出/導入宏（最清晰）

// MyDLL.h
#ifdef BUILDING_MYDLL
#define MYDLL_API __declspec(dllexport)
#else
#define MYDLL_API __declspec(dllimport)
#endif

// MyDLL.cpp
#define BUILDING_MYDLL
#include "MyDLL.h"

驗證檢查清單

• ☐ DLL 專案屬性頁確實定義了導出宏
• ☐ 實現文件編譯時宏展開為 dllexport（可在輸出窗口查看預處理結果 /P）
• ☐ 客戶端專案未定義該宏，自動展開為 dllimport
• ☐ .def 文件（如使用）與 __declspec 方式二選一，別混用

延伸：數據導出同理

// 變量導出同樣遵循此規則
MYDLL_API int g_globalVar;      // 頭文件聲明
MYDLL_API int g_globalVar = 42; // 實現文件定義（需在導出宏生效下）