ctypes加载.so/.dll找不到符号主要因路径错误、符号名不匹配或依赖缺失：需用绝对路径加载，Linux用ldd查依赖，Windows用dumpbin确认导出函数，C++函数须加extern "C"，并正确声明argtypes/restype。
ctypes 加载 .so/.dll 时找不到符号怎么办
多数失败源于路径或符号名不匹配。Python 的 ctypes.CDLL 或 ctypes.WinDLL 不会自动搜索系统 PATH 或 LD_LIBRARY_PATH，必须传入绝对路径或确保库在当前工作目录下。
常见错误现象：OSError: cannot load library 或 AttributeError: function 'xxx' not found。
- Linux/macOS 下用
ldd your_lib.so检查依赖是否完整，缺失的 .so 会导致加载失败 - Windows 下用
dumpbin /exports your_lib.dll确认导出函数名——注意 C++ 编译器会做 name mangling，必须用extern "C"包裹函数声明 - 函数名区分大小写，且默认是 C 调用约定（
__cdecl），Windows 上若用__stdcall必须改用ctypes.WinDLL - 推荐先用
os.path.abspath("libxxx.so")构造路径，避免相对路径陷阱
如何正确声明 C 函数参数和返回值类型
ctypes 默认把所有参数当 c_int、返回值当 c_int，不显式声明会导致内存读写越界或值截断。
例如 C 函数 int add(int a, int b) 可以直接调用；但若为 double multiply(double x, double y)，就必须设置 restype 和 argtypes：
立即学习“Python免费学习笔记（深入）”；
lib = ctypes.CDLL("./libmath.so")
lib.multiply.restype = ctypes.c_double
lib.multiply.argtypes = [ctypes.c_double, ctypes.c_double]
result = lib.multiply(3.5, 2.1) # 此时 result 是 Python float
-
char*对应ctypes.c_char_p，但注意：传入 bytes（不是 str），返回值需用.decode()转字符串 - 结构体需定义
ctypes.Structure子类，并显式指定_fields_；字段顺序、对齐必须与 C 端完全一致 - 数组传参常用
(ctypes.c_int * 5)()创建长度为 5 的 int 数组实例，再传给函数 - 指针类型用
ctypes.byref(var)或ctypes.pointer(var)，前者更轻量，后者可解引用
回调函数从 Python 传入 C 怎么写
C 库常要求注册回调，比如日志函数或数据处理钩子。ctypes 提供 CFUNCTYPE（对应 __cdecl）或 WINFUNCTYPE（对应 __stdcall）来包装 Python 函数。
关键点在于：Python 回调对象必须被变量持久引用，否则会被 GC 回收，C 端再次调用时触发崩溃。
- 声明回调类型时，参数和返回类型要和 C 原型严格一致，例如 C 原型
void (*log_cb)(const char* msg)→LOG_CB = ctypes.CFUNCTYPE(None, ctypes.c_char_p) - 用
LOG_CB(python_func)创建可传入 C 的回调句柄 - 务必把该句柄赋值给一个模块级或类成员变量（如
self._cb = LOG_CB(my_handler)），不能只写成lib.set_callback(LOG_CB(my_handler)) - 如果回调里需要访问 Python 对象，注意 GIL 问题：C 函数调用期间 Python 解释器可能被锁住，长时间操作建议用
ctypes.pythonapi.PyThreadState_Get()手动释放 GIL
跨平台编译和 ABI 兼容性容易被忽略的点
同一份 C 源码在不同平台编译出的动态库，不能混用。更隐蔽的问题是 ABI 差异：比如 Linux 上用 GCC 编译的 long 是 8 字节，而 Windows MSVC 的 long 是 4 字节。
- 避免直接使用
long、size_t等平台相关类型；C 端改用int32_t/uint64_t，Python 端对应用c_int32/c_uint64 - struct 中若含指针字段（如
char*），不要在 C 侧 free 它——Python 分配的内存生命周期由 Python 管理 - macOS 上 .dylib 需设置
-install_name，否则ctypes加载时可能找不到依赖 - Python 的位数（32/64）必须和动态库一致，混用会直接报
OSError: dlopen() failed
最麻烦的不是调用失败，而是调用成功但结果错乱——这类问题往往卡在类型声明或内存布局上，建议 C 端加简单单元测试，再用 ctypes 封装一层薄胶水代码验证行为一致性。
