用 setup.py 编译 C 扩展最稳妥，因 setuptools 自动处理 ABI、头文件路径和编译器标志；PyInit_模块名必须严格匹配；错误处理需 PyErr_SetString + return NULL；Windows 必须用对应 MSVC 版本。
用 setup.py 编译 C 扩展是最稳的路径
Python 官方不推荐手动调用 gcc 或 cl 编译 C 模块，因为 ABI 兼容性、链接路径、Python 头文件位置都得自己硬配，稍有偏差就报 ImportError: dynamic module does not define module export function 或直接段错误。setuptools 封装了这些细节，且能自动适配当前 Python 解释器的架构和编译器标志。
实操建议：
- 必须在项目根目录写
setup.py，哪怕只编译一个.c文件 -
Extension构造时，include_dirs通常不用显式写 ——setuptools会自动注入Python.h所在路径 - 如果 C 代码依赖第三方库（如
libz），才需补上libraries=['z']和library_dirs - 运行
python setup.py build_ext --inplace，生成的.so（Linux/macOS）或.pyd（Windows）会直接落在当前目录，可立刻import
PyInit_模块名 函数名必须严格匹配模块名
这是最常导致 ImportError: dynamic module does not define module export function 的原因。Python 3.2+ 要求 C 扩展导出的初始化函数名是 PyInit_ 加模块名（不含路径和后缀），且大小写、下划线、拼写必须完全一致。
常见错误现象：
立即学习“Python免费学习笔记（深入）”；
- 模块文件叫
myext.c，但写了PyInit_my_ext→ 报错 - 用
python -m myext运行，但模块名其实是myext，不是my_ext→ 报错 - Windows 下误写成
PyInit_myext()但setup.py里name='my_ext'→ 不匹配
验证方法：编译后用 nm -D myext.so | grep PyInit（Linux/macOS）或 dumpbin /exports myext.pyd（Windows）确认符号名是否正确。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
调试时别跳过 PyErr_SetString 和 return NULL
C 扩展里任何 Python API 调用失败（比如 PyLong_FromLong 返回 NULL），都必须立刻设置异常并返回 NULL，否则 Python 解释器会继续执行后续代码，轻则结果错乱，重则崩溃。这不是“可选的错误处理”，而是 C API 的强制契约。
使用场景：
- 所有接收 Python 对象的函数入口，第一件事应是
if (!PyUnicode_Check(args)) { PyErr_SetString(PyExc_TypeError, "expected str"); return NULL; } - 调用
PyObject_CallObject后必须检查返回值，不能直接PyLong_AsLong - 忘记
return NULL是静默陷阱 —— 编译通过，运行时行为不可预测
简短示例：
static PyObject* myext_add(PyObject* self, PyObject* args) {
long a, b;
if (!PyArg_ParseTuple(args, "ll", &a, &b)) {
// 必须设异常 + return NULL
return NULL;
}
return PyLong_FromLong(a + b);
}
Windows 上用 MSVC 编译要对齐 Python 版本
Python 官方二进制分发版（从 python.org 下载）全部用 Microsoft Visual Studio 编译，且版本严格绑定：Python 3.9 → MSVC 14.2（VS 2019），Python 3.11 → MSVC 14.3（VS 2022）。用错编译器会导致 LNK2001: unresolved external symbol _PyInit_myext 或加载时 DLL 初始化失败。
实操建议：
- 查当前 Python 使用的 MSVC 版本：
python -c "import sysconfig; print(sysconfig.get_config_var('MSSdk'))"，再对照 Python Windows 编译器对应表 - 不要用 MinGW 或 Clang for Windows 直接编译 —— 即使成功，也无法与官方 Python 链接
python39.lib等导入库 - 若没有对应 VS，可用
pip install setuptools wheel后直接pip wheel .，它会自动拉取预编译的构建环境（CI 场景更可靠）
跨平台发布时，manylinux、macosx_x86_64、win_amd64 这些标签不是装饰，它们决定了你用哪套工具链编译 —— 混用等于白忙。
