Nuitka 编译生成的 .pyd 模块必须保留原始文件名（含平台和 Python 版本标识），否则 Python 导入机制将因找不到对应的 PyInit_ 初始化函数而报错。
nuitka 编译生成的 `.pyd` 模块必须保留原始文件名（含平台和 python 版本标识），否则 python 导入机制将因找不到对应的 `pyinit_` 初始化函数而报错。
在使用 Nuitka 将 Python 模块编译为原生扩展（.pyd 文件）时，一个常见但关键的误区是手动重命名输出文件。例如，你执行了如下命令编译模块：
nuitka --module --debug --msvc=latest --disable-ccache get_slices_from_camCalib_apex.py
Nuitka 默认会生成形如 get_slices_from_camCalib_apex.cp311-win_amd64.pyd 的文件（其中 cp311 表示 CPython 3.11，win_amd64 表示 Windows 64 位平台）。该文件名并非随意命名的标签，而是 Python 动态导入机制的关键依据。
当 Python 执行 import get_slices_from_camCalib_apex 时，它会：
- 自动查找匹配的 .pyd 文件（优先按 module_name + .cpXX-win_XX.pyd 规则）；
- 调用其内部导出的初始化函数 PyInit_get_slices_from_camCalib_apex（函数名由模块名下划线转驼峰并加 PyInit_ 前缀）；
- 若文件名被手动改为 getSlicesFromCamCalibApexCp311winAmd64.pyd，Python 仍会尝试查找 PyInit_getSlicesFromCamCalibApexCp311winAmd64 —— 但该函数实际并不存在，因为 Nuitka 是根据源文件名 get_slices_from_camCalib_apex 生成对应初始化符号的，导致 ImportError: dynamic module does not define module export function (PyInit_...)。
✅ 正确做法：
立即学习“Python免费学习笔记（深入）”；
- 绝不重命名 .pyd 文件；保持原始名称（如 get_slices_from_camCalib_apex.cp311-win_amd64.pyd）；
- 在代码中使用与源模块名一致的 import 语句：
import get_slices_from_camCalib_apex # ✅ 正确：与源文件名、编译输出名基础部分完全一致 # 而非： # import getSlicesFromCamCalibApexCp311winAmd64 # ❌ 错误：名称不匹配 # import getSlicesFromCamCalibApexCp311winAmd64.pyd # ❌ 语法错误：不能带 .pyd 后缀导入
⚠️ 注意事项：
- .pyd 是 Windows 下的动态链接库，导入时不写后缀，也不带路径（除非添加到 sys.path）；
- 确保 .pyd 文件与运行脚本位于同一目录，或已加入 PYTHONPATH/sys.path；
- 若需跨平台或版本兼容，建议通过 --include-package 或构建分发包方式管理依赖，而非手动搬运 .pyd；
- 可用 dumpbin /exports your_module.cp311-win_amd64.pyd（Windows）验证导出函数是否存在 PyInit_get_slices_from_camCalib_apex。
总结：Nuitka 生成的扩展模块是“名字敏感型”组件——文件名、源模块名、导出函数名三者严格绑定。尊重这一约定，即可避免绝大多数 ImportError。
