Python ctypes跨平台调用：Intel Mac与Windows回调结构体结果异常

结构体值错乱是回调函数签名不匹配+ctypes配置笔误共同导致的，Windows平台运行正常只是调用约定差异下的偶然巧合，Mac平台遵循System V AMD64 ABI，参数传递规则和Windows x64不同，直接触发了不匹配问题。
具体错误点：

• 核心错误：C/C++侧回调为值传递结构体，Python侧错误声明为指针参数
  C头文件中回调签名定义为void (*callback)(struct ProgressReport)，调用时直接传入栈上的pr结构体本体，属于值传参；但Python侧定义回调类型时参数写为ctypes.POINTER(ProgressReportC)，告知ctypes回调会收到结构体指针。
  ctypes会按照声明类型解析参数：把C侧传入的结构体值的前8字节（64位系统指针长度）当成内存地址寻址读取，读到的自然是随机乱码。
• 配置笔误：ctypes函数参数类型属性名写错
  代码中给doThing设置参数类型时写的是_dothing.argtype = ...，ctypes正确的参数配置属性是argtypes（复数形式），这行配置完全不生效，ctypes不会自动做参数转换、也不会做签名校验，进一步放大了签名不匹配的问题。
• Windows下正常的原因：Windows x64调用约定对小尺寸结构体的值传递处理逻辑，和指针传递的栈/寄存器布局存在偶然重叠，属于未定义行为下的巧合，Mac平台的调用约定会将值传递的结构体按字段拆分到寄存器传递，不会传入内存地址，直接触发解析错误。

按以下步骤修改即可，不需要改动C侧代码重新编译：

1. 修正回调类型定义，匹配C侧的值传递逻辑，同时调整回调函数的参数解析逻辑：

# 回调参数直接声明为结构体类型，对应C侧的值传递，不再用指针
_callback_type = ctypes.CFUNCTYPE(None, ProgressReportC)

def _status_report(prog):
    # 直接访问传入的结构体对象，不需要调用.contents解引用指针
    progress_report = {'tab_num': prog.tab,
                        'number_of_stages': prog.numberOfStages ,
                        'current_readable_operation': prog.currentStage,
                        'current_percent': prog.progressPercent, 
                        'current_stage': prog.currentStage,
                        'current_stage_progress': prog.currentStageProgress}
    print(progress_report)

2. 修正ctypes函数参数配置的笔误，使用正确的argtypes属性传入参数类型元组：

_dothing = polyDll['doThing']
# 注意是argtypes（复数），值为参数类型组成的元组
_dothing.argtypes = [_callback_type]
_dothing.restype = None

3. （可选校验）如果修改后仍有个别字段错位，可以显式指定结构体对齐规则和C侧一致，在结构体类中添加_pack_ = 8即可，当前两侧字段顺序、类型完全匹配，默认8字节对齐不需要额外调整。

修改完成后重新运行脚本，回调收到的数值会和dylib内部打印的数值完全一致，不会再出现乱码。

内容的提问来源于stack exchange，提问作者ameyeralvarez