Python ctypes 模块详解

什么是 ctypes？

ctypes 是 Python 标准库中的一个模块，用于调用动态链接库（如 Windows 的 .dll 或 Linux/macOS 的 .so 文件）中的 C 函数。它允许你在不编写任何 C 扩展代码的情况下，直接与 C 语言编写的库进行交互。

基本用法示例

以下是一个简单的例子：调用系统 C 库中的 printf 函数（在 Linux/macOS 上）：

import ctypes

# 加载 C 标准库（Linux/macOS）
libc = ctypes.CDLL("libc.so.6")  # macOS 可能是 libSystem.dylib

# 调用 printf
libc.printf(b"Hello from C!\n")

在 Windows 上，可以这样调用系统 API：

import ctypes

user32 = ctypes.windll.user32
user32.MessageBoxW(0, "Hello from ctypes!", "Message", 0)

常用功能概览

• 加载动态库：使用 CDLL()、WinDLL() 或 PyDLL()
• 声明函数参数与返回类型：通过 argtypes 和 restype 属性
• 数据类型映射：如 c_int、c_char_p、POINTER() 等
• 结构体与联合体：通过继承 ctypes.Structure 定义 C 风格结构
• 回调函数：将 Python 函数作为 C 函数指针传入

实战：定义并调用自定义 C 函数

假设你有一个 C 文件 math_utils.c：

// math_utils.c
int add(int a, int b) {
    return a + b;
}

编译为共享库（Linux）：

gcc -shared -fPIC -o math_utils.so math_utils.c

然后在 Python 中调用：

import ctypes

lib = ctypes.CDLL("./math_utils.so")
lib.add.argtypes = (ctypes.c_int, ctypes.c_int)
lib.add.restype = ctypes.c_int

result = lib.add(3, 5)
print("3 + 5 =", result)  # 输出: 3 + 5 = 8

注意事项

• 确保调用约定（calling convention）匹配（如 stdcall vs cdecl）
• 字符串需转换为字节（b"..."）或使用 c_wchar_p 处理宽字符
• 内存管理需谨慎：避免传递临时对象给 C 函数长期持有
• 跨平台时注意库文件命名差异（.dll / .so / .dylib）

适用场景

1. 调用现有 C/C++ 库，避免重写
2. 性能关键部分使用 C 实现，Python 负责高层逻辑
3. 与操作系统底层 API 交互（如 Windows API）
4. 快速原型验证，无需编译 Python 扩展模块