Python导入.pyd文件机制解析及适配Python3.9的方案问询

一、当前场景的导入机制细节 #

当你执行import my_package as pkg时，Python的导入流程如下：

1. 定位到my_package目录，优先执行其中的__init__.py文件。
2. 执行__init__.py中的from .wrapper import *语句时，Python会尝试查找匹配当前解释器环境的wrapper模块。
3. 对于Windows平台的C扩展模块（.pyd文件本质是适配Python的动态链接库），Python会严格按照模块名.cp{主版本}{次版本}-平台架构.pyd的命名规则查找文件。比如Python 3.8会精准匹配wrapper.cp38-win_amd64.pyd，而3.9及以上版本会寻找对应版本后缀的.pyd文件——找不到匹配文件时，导入就会失败，这就是你遇到的问题根源。

二、适配Python 3.9的解决方案 #

1. 最简方案：添加对应版本的.pyd文件 #

仅添加针对Python 3.9构建的wrapper.cp39-win_amd64.pyd文件通常足够，但需要满足两个前提：

• 底层的my_lib.dll是独立于Python版本的纯C++逻辑，没有直接依赖Python 3.8的特定C API或运行时。
• 构建3.9版本的wrapper.pyd时，使用的Python C API与原3.8版本的wrapper逻辑兼容（Python C API在小版本迭代中稳定性较高，除非使用了已废弃或变更的接口）。

2. 自定义导入逻辑（多版本兼容场景） #

如果你的包需要同时支持多个Python版本，且希望自动适配当前环境，可以修改__init__.py添加版本检测与动态加载逻辑：

import sys
import importlib.util
import os

# 生成对应Python版本的pyd文件名
py_version_tag = f"cp{sys.version_info.major}{sys.version_info.minor}"
target_pyd = f"wrapper.{py_version_tag}-win_amd64.pyd"
pyd_full_path = os.path.join(os.path.dirname(__file__), target_pyd)

# 动态加载对应版本的C扩展模块
spec = importlib.util.spec_from_file_location("my_package.wrapper", pyd_full_path)
if spec is None or spec.loader is None:
    raise ImportError(f"Unsupported Python version: no {target_pyd} found")
wrapper_module = importlib.util.module_from_spec(spec)
spec.loader.exec_module(wrapper_module)

# 将模块内容导入当前命名空间
globals().update(vars(wrapper_module))

# 原有其他代码
...

这种方式可以让包自动匹配当前Python版本对应的.pyd文件，无需用户手动干预。

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