DLL 標頭檔規範設計與導出/導入巨集最佳實踐

實務上強烈建議統一採用 C 連結，以最大化相容性。

演進：從分離標頭到統一標頭

早期做法：DLL 專案用 dllexport 標頭，客戶端用 dllimport 標頭，維護兩份檔案。進階做法：定義控制巨集 _DLLMODULENAME_，單一標頭檔雙向服務。

最終統一標頭檔範本 MyDll.h

#ifndef _MYDLL_H
#define _MYDLL_H

#include <windows.h>   // 必要系統標頭

#ifdef __cplusplus
extern "C" {
#endif

// 控制巨集：DLL 專案定義 _MYDLL_，客戶端不定義
#ifdef _MYDLL_
#define MYDLL_API __declspec(dllexport)
#else
#define MYDLL_API __declspec(dllimport)
#endif

// 導出/導入函數宣告
MYDLL_API int  MyFunc1(int a, double b);
MYDLL_API void MyFunc2(const char* msg);
// ... 更多宣告

#undef MYDLL_API

#ifdef __cplusplus
}
#endif
#endif // _MYDLL_H

使用方式

1. DLL 實作專案：在包含標頭檔之前定義控制巨集：

#include "stdafx.h"
#define _MYDLL_
#include "MyDll.h"

int MyFunc1(int a, double b) { return a + (int)b; }
void MyFunc2(const char* msg) { puts(msg); }

2. 客戶端專案：直接包含標頭檔並連結 .lib：

#include "MyDll.h"
#pragma comment(lib, "MyDll.lib")

int main() { MyFunc1(1, 2.5); MyFunc2("Hello DLL"); }

注意事項

• 導出類別時，整個類別標記 MYDLL_API，所有成員函數自動導出。
• 避免在標頭檔中定義非 inline 函數實作，防止多重定義連結錯誤。
• 若需支援 C 語言客戶端，確保標頭檔在 C 編譯環境下也能編譯（不使用 C++ 專屬語法）。

遵循此規範，可構建乾淨、可維護、跨語言友善的 DLL 介面。