DLL 導出 STL 容器完整指南：显式實例化與 __declspec 跨界傳遞

DLL 無法直接導出模板類別，必須先**顯式實例化**再匯出。本文詳述導出 `std::vector` 等 STL 容器、包含 STL 成員的類別、自定型別作模板參數時的完整步驟與陷阱。

核心限制與規則

• 僅 `std::vector` 可導出；`map`/`set`/`list`/`deque`/`queue` 含巢狀類別無法導出
• DLL 與 EXE **必須連結相同版本 CRT**：同為 `Msvcrt.lib` (Release) 或 `Msvcrtd.lib` (Debug)
• 導出端：`__declspec(dllexport)` + 顯式實例化
• 使用端：`__declspec(dllimport)` + `extern` 宣告

步驟一：導出基本 STL 容器實例

// VecDLL.h
#ifdef VECDLL_EXPORTS
#define VECDLL_API __declspec(dllexport)
#else
#define VECDLL_API __declspec(dllimport)
#endif

// 顯式實例化宣告 (DLL 端定義，EXE 端引用)
#define EXPIMP_TEMPLATE extern VECDLL_API

// 導出 std::vector
EXPIMP_TEMPLATE template class VECDLL_API std::vector;

// 導出函數
VECDLL_API int fnVecDll(std::vector& vec);

// VecDLL.cpp
#include "VecDLL.h"
// 顯式實例化定義 (僅 DLL 端編譯)
template class VECDLL_API std::vector;

int fnVecDll(std::vector& vec) {
    vec.push_back(42);
    return vec.size();
}

步驟二：導出自定型別為元素的容器

自定型別必須實作 `operator<` 與 `operator==`（STL 容器比較操作需求）：

class CPerson {
public:
    int m_nAge;
    char m_strName[40];
    bool operator<(const CPerson& c) const { return m_nAge < c.m_nAge; }
    bool operator==(const CPerson& c) const { return m_nAge == c.m_nAge; }
};

// 導出 std::vector
EXPIMP_TEMPLATE template class VECDLL_API std::vector;
VECDLL_API int fnVecDllPerson(std::vector& vec);

原因：顯式實例化會強制實例化容器所有成員函數（含比較操作），故需提供比較運算子。若不關心語意，可單純 `return true`。

步驟三：導出包含 STL 成員的類別

// 先導出成員容器實例
EXPIMP_TEMPLATE template class VECDLL_API std::vector;

class VECDLL_API CContainer {
public:
    std::vector m_vecNum;
    void Add(int n) { m_vecNum.push_back(n); }
    int Size() const { return m_vecNum.size(); }
};

完整專案結構

• VecDLL.h：共用介面宣告（含 `EXPIMP_TEMPLATE` 巨集）
• VecDLL.cpp：DLL 實作與顯式實例化定義
• ClientEXE.cpp：引用 DLL，連結 `VecDLL.lib`

常見錯誤與解決

最佳實踐建議

1. **介面抽象化**：DLL 導出純虛擬介面類別，內部實作隱藏 STL 細節
2. **避免跨 DLL 傳遞 STL 物件**：改傳遞資料指標/陣列，或使用 COM/WinRT 介面
3. **統一建置環境**：全方案同一 CRT、同一 STL 實作 (MSVC 標準庫)
4. **測試矩陣**：Debug/Release、x86/x64、靜態/動態 CRT 全組合驗證

原始碼下載

完整 DLL/EXE 範例專案已附於配套資源。