在 Windows C/C++ 开发中，调用约定（Calling Convention） 是影响程序稳定性和兼容性的关键知识。它决定了函数如何传递参数、管理堆栈和返回值。本文将深入解析三种最常用的调用约定：__stdcall、__cdecl 和 __fastcall，帮助您写出更健壮的代码。
一、为什么需要调用约定？
想象两个开发者合作：A 用 C++ 写函数，B 用 Python 调用。如果没有统一规则，会发生什么？
问题后果参数传递顺序不同数据错位堆栈清理责任不明内存泄漏/崩溃名称修饰规则不一致链接失败
调用约定就是解决这些问题的 二进制接口协议，尤其在 Windows 开发中至关重要。
二、三大调用约定全景对比
特性__cdecl (C 声明)__stdcall (标准调用)__fastcall (快速调用)堆栈清理责任调用者清理被调用函数清理被调用函数清理参数传递顺序从右向左从右向左从右向左参数传递方式全部通过堆栈全部通过堆栈前两个参数通过寄存器名称修饰规则_funcName_funcName@8@funcName@8可变参数支持✅ (如 printf)❌❌典型应用场景C/C++ 默认函数Windows API性能敏感型函数内存占用稍大（多次清理）较小最小性能特点一般一般最快（寄存器传递）
三、深度解析各约定特点
1. __cdecl：C 语言的默认约定
// 显式声明
int __cdecl add(int a, int b) {
return a + b;
}
// 隐式声明（默认行为）
int subtract(int a, int b) {
return a - b;
}
核心特点：
可变参数支持：唯一支持 printf 等变参函数的约定调用者清理堆栈：
; 调用代码示例
push 3
push 5
call _add
add esp, 8 ; 调用者清理堆栈
兼容性最强：跨语言调用最安全的选择
2. __stdcall：Windows API 的标准
// 典型的Win32 API声明
WINAPI MessageBoxA( // WINAPI 宏即 __stdcall
HWND hWnd, // 窗口句柄
LPCSTR lpText, // 文本内容
LPCSTR lpCaption, // 标题
UINT uType // 按钮类型
);
核心特点：
被调用方清理堆栈：
; 函数内部清理
ret 16 ; 清理16字节参数
严格的名称修饰：确保 DLL 导出函数可被正确定位系统级使用：
窗口过程：LRESULT CALLBACK WndProc(...)线程函数：DWORD WINAPI ThreadProc(...)
3. __fastcall：性能至上的选择
// 前两个参数通过ECX和EDX传递
int __fastcall fast_add(int a, int b) {
return a + b;
}
核心特点：
寄存器优先：
平台第一个参数第二个参数x86ECXEDXx64RCXRDX
使用场景：
// 高频调用的数学运算
float __fastcall DotProduct(
const Vector3& v1, // 通过引用传递
const Vector3& v2
);
四、跨语言调用实战演示
1. C# 调用 C++ DLL（使用 __stdcall）
[DllImport("MyLib.dll",
CallingConvention = CallingConvention.StdCall)]
public static extern int Add(int a, int b);
2. Python 调用 C++（使用 __cdecl）
from ctypes import CDLL, c_int
lib = CDLL("./MyLib.dll")
lib.add.argtypes = [c_int, c_int]
lib.add.restype = c_int
result = lib.add(5, 3) # __cdecl 调用
五、常见错误与解决方案
❌ 错误 1：约定不匹配
// DLL 导出为 __stdcall
extern "C" __declspec(dllexport)
int __stdcall Calc(int a, int b);
// 调用方错误使用 __cdecl 指针
typedef int (__cdecl *CalcFunc)(int, int);
💥 后果：堆栈损坏，程序崩溃
✅ 修复：
typedef int (__stdcall *CalcFunc)(int, int);
❌ 错误 2：忽略名称修饰
// C++ 默认名称修饰（不同编译器不同）
void func(); // 可能被修饰为 ?func@@YAXXZ
// C 语言导出
extern "C" void __cdecl func(); // _func
❌ 错误 3：线程回调约定错误
// _beginthread 要求 __cdecl
void __stdcall ThreadProc(void*); // ❌ 错误！
// 正确声明
void __cdecl ThreadProc(void*); // ✅
六、现代 C++ 最佳实践
1. 使用类型别名增强可读性
using WinCallback = void(__stdcall*)(HWND, UINT);
using ThreadProc = void(__cdecl*)(void*);
2. 通过 SAL 注解提升安全性
void __stdcall SafeCallback(
_In_ HWND hwnd, // 输入参数
_Out_ int* pResult // 输出参数
);
3. 64 位统一调用约定
在 x64 架构中：
只有一种核心约定：__fastcall 变体前四个参数通过寄存器传递：RCX, RDX, R8, R9
七、总结与选择指南
场景推荐约定理由普通 C/C++ 函数__cdecl默认安全Windows API 开发__stdcall系统兼容高性能数学计算__fastcall速度优先可变参数函数__cdecl唯一选择跨语言调用（C#/Python）__stdcall最稳定
📌 本文原创首发于CSDN，转载请注明出处！