C/C++ 動態鏈接庫創建全解析：extern "C" 與 __declspec(dllexport/dllimport) 深度解析

一、extern "C"：跨語言鏈接的橋樑

1. 名稱修飾問題

C++ 支持函數重載，編譯器通過名稱修飾將函數簽名編碼進符號名：void foo(int, float) → _foo_int_float。C 語言無重載，符號名僅為 _foo。直接混用會導致鏈接階段找不到符號。

2. extern "C" 作用

• 指示編譯器：按 C 語言規則生成符號名（不修飾）
• 使 C++ 代碼可被 C 語言調用，或被 GetProcAddress/DllImport 按名查找

3. 標準頭文件護衛模板

#ifndef MYLIB_H
#define MYLIB_H

#ifdef __cplusplus
extern "C" {
#endif

// 函數聲明
int add(int a, int b);
void init();

#ifdef __cplusplus
}
#endif

#endif

4. 雙重含義解析

• extern：聲明符號具有外部鏈接，可跨文件訪問（對應 static 內部鏈接）
• "C"：指定C 語言鏈接規約（無名稱修飾）

5. 混合編程四種場景

二、__declspec(dllexport) / __declspec(dllimport)

1. dllexport：導出符號

將函數/類/變量放入 DLL 導出表，供外部調用。等價於 .def 文件 EXPORTS 節。

__declspec(dllexport) int add(int a, int b);  // 導出函數
__declspec(dllexport) class MyClass { ... };  // 導出整個類

2. dllimport：導入符號（優化調用）

• 函數：非必需，但允許編譯器生成直接調用指令（跳過 IAT 間接跳轉），提升性能
• 數據/變量：必須使用，否則無法正確訪問 DLL 中的全局/靜態變量

3. 經典宏切換模式

#ifdef MYLIB_EXPORTS  // DLL 端定義此宏
#define MYLIB_API __declspec(dllexport)
#else                 // 客戶端不定義
#define MYLIB_API __declspec(dllimport)
#endif

MYLIB_API int add(int a, int b);
MYLIB_API class MyClass { ... };

4. 類導出與靜態成員陷阱

導出類時，靜態成員變量必須在客戶端正確導入：

// MyClass.h
class MYLIB_API MyClass {
    static int s_value;  // 靜態成員
public:
    static int getValue();
};

// MyClass.cpp (DLL 端)
int MyClass::s_value = 0;  // 定義

// 客戶端若無 dllimport，鏈接時找不到 s_value！

原因：靜態成員實際在 DLL 數據段，客戶端需通過 dllimport 正確解析地址。類導出宏自動處理成員函數，但靜態數據成員需顯式 dllimport。

三、完整實戰：C++ DLL + C# 調用

1. C++ DLL 導出

// MathLib.h
#ifdef MATHLIB_EXPORTS
#define MATH_API __declspec(dllexport)
#else
#define MATH_API __declspec(dllimport)
#endif

extern "C" MATH_API int Add(int a, int b);
extern "C" MATH_API int Sub(int a, int b);

// MathLib.cpp
#include "MathLib.h"
extern "C" MATH_API int Add(int a, int b) { return a + b; }
extern "C" MATH_API int Sub(int a, int b) { return a - b; }

2. C# P/Invoke 調用

public static class MathLib {
    [DllImport("MathLib.dll", CallingConvention = CallingConvention.Cdecl)]
    public static extern int Add(int a, int b);
    
    [DllImport("MathLib.dll", CallingConvention = CallingConvention.Cdecl)]
    public static extern int Sub(int a, int b);
}

// 使用
int sum = MathLib.Add(10, 20);  // 30

關鍵點

• CallingConvention.Cdecl：匹配 C/C++ 默認調用約定（調用方清棧）
• x64 平台：C++ 編譯目標 x64，C# 目標平台 x64，DLL 放入輸出目錄
• 依賴檢查：Dependency Walker 確認導出符號名無修飾（Add 而非 _Add@8）

四、常見錯誤與調試

總結

1. extern "C" 解決名稱修飾，實現 C/C++/C# 互調
2. dllexport/dllimport 管理導出導入，優化調用、正確訪問數據
3. 宏切換 單一頭文件服務 DLL 端與客戶端
4. 調用約定、位數、符號名 三一致是跨語言調用鐵律

1. 上一篇文章： C++ STL list 容器完整指南：雙向鏈表操作詳解與迭代器失效避坑
2. 下一篇文章： 判斷凸多邊形並按順時針序輸出頂點算法（Java 實現）

關於C++

C 語言順序棧實現：動態擴容、泛型設計、完整 API 與測試代碼

前言 順序棧是基礎數據結構，掌握其動態擴容、泛型設計、邊界處

UVA 1626 / ZOJ 1463 括号序列：区间 DP 构造最短合法超序列

题目大意 给定由 ()[] 组成的字符串（长 ≤ 100），

Sicily 1422 Table Tennis：最小公倍數與反射建模

問題描述 矩形桌球桌 ABCD，邊長 m（寬）和 n（長），

C++ 智慧指標進階：shared_ptr 循環引用與自定義刪除器深度解析

shared_ptr 循環引用問題 shared_ptr 採

LeetCode 每日一題：合併兩個有序數組（尾插法） Win7 64位系統安裝 Borland C++ 3.1 失敗全記錄：16位應用兼容性死結 BZOJ 2683 簡單題 - CDQ 分治 + 樹狀數組 維護矩陣單點修改/子矩陣查詢 HDU 2037：今年暑假不 AC (貪心區間調度) C/C++ 快速排序演算法完整實現與解析 擴展歐幾里得算法 C 語言實現：求解 ax + by = gcd(a,b) How Tomcat Works 讀書筆記 Chapter 2：Servlet 容器核心實現

欄目導航

C++ 基礎

C++ 入門

關於C++

Copyright © 程式碼之家 All Rights Reserved

錯誤	原因	解決
Unresolved external symbol	缺少 dllexport / 宏未定義	檢查 MYLIB_EXPORTS 定義、頭文件包含順序
BadImageFormatException	x86/x64 不匹配	統一編譯目標平台
EntryPointNotFound	名稱修飾 / 拼寫錯誤	加 extern "C"、用 Dependency Walker 查導出名
靜態成員訪問失敗	缺少 dllimport	類導出宏需覆蓋靜態數據成員