使用SWIG构建Python C++绑定包后无法全局导入问题求助

执行pip install -e .无报错，但仅能在date目录下正常导入date模块；在其他目录（如IRDLIB/time）执行import date会触发模块错误。当前使用的setup.py代码如下：

from distutils.core import setup, Extension

import os
import sys
import shutil
from sys import platform

if platform == "darwin":
    IRDLIB_PATH = "/Users/john/Documents/GitHub/IRDLIB/IRDLIB/time"
    IRDLIB_SWIG_PATH = "/Users/john/Documents/GitHub/IRDLIB/IRDLIB-SWIG/SWIG"

    # Clean build
    for file in os.listdir(IRDLIB_SWIG_PATH + "/date"):
        if file in ["__init__.py", "test.ipynb", "__pycache__"]:
            continue
        else:
            os.remove(IRDLIB_SWIG_PATH + "/date/" + file)
    os.system(
        "swig -c++ -python -I" + IRDLIB_PATH + " -outdir " + IRDLIB_SWIG_PATH + "/date"
        " -o "
        + IRDLIB_SWIG_PATH
        + "/date/date_wrap.cpp "
        + IRDLIB_SWIG_PATH
        + "/date.i"
    )
    name = "date"  # name of the module
    version = "1.0"  # the module's version number
    setup(
        name=name,
        version=version,
        py_modules=["SWIG.date.__init__", "SWIG.date.date"],
        include_dirs=[IRDLIB_PATH],
        ext_modules=[
            Extension(
                "SWIG.date._date",
                ["SWIG/date/date_wrap.cpp", IRDLIB_PATH + "/date.cpp"],
                include_dirs=[IRDLIB_PATH],
                depends=[IRDLIB_PATH + "/date.hpp"],
            )
        ],
    )

1. 命名空间与包路径不匹配：setup中py_modules和Extension的命名带了SWIG.前缀，但你期望导入的是顶层模块date，导致Python无法在全局路径中找到正确的模块。
2. SWIG生成文件的路径配置错误：SWIG的-outdir指向的是IRDLIB_SWIG_PATH/date，但setup没有将这个目录正确注册为Python包的顶层目录。
3. 开发模式路径映射问题：pip install -e .会将当前目录链接到site-packages，但你的包结构未遵循标准Python包布局，导致全局路径无法识别date模块。

1. 调整包结构 #

将date目录作为顶层Python包（与setup.py同级），目录内必须保留__init__.py。调整后结构大致如下：

IRDLIB-SWIG/
├── setup.py
└── date/
    ├── __init__.py
    ├── date.i
    └── test.ipynb

2. 修改setup.py配置 #

修正命名空间、扩展模块路径和SWIG命令参数：

from distutils.core import setup, Extension

import os
import sys
from sys import platform

if platform == "darwin":
    IRDLIB_PATH = "/Users/john/Documents/GitHub/IRDLIB/IRDLIB/time"
    # 直接用当前目录下的date包路径
    DATE_PACKAGE_PATH = "./date"

    # Clean build
    for file in os.listdir(DATE_PACKAGE_PATH):
        if file in ["__init__.py", "test.ipynb", "__pycache__"]:
            continue
        os.remove(os.path.join(DATE_PACKAGE_PATH, file))
    
    # 修正SWIG命令，outdir指向顶层date包
    os.system(
        f"swig -c++ -python -I{IRDLIB_PATH} -outdir {DATE_PACKAGE_PATH} "
        f"-o {os.path.join(DATE_PACKAGE_PATH, 'date_wrap.cpp')} "
        f"{os.path.join(DATE_PACKAGE_PATH, 'date.i')}"
    )

    setup(
        name="date",
        version="1.0",
        # 注册顶层date包的模块
        py_modules=["date.__init__", "date.date"],
        include_dirs=[IRDLIB_PATH],
        ext_modules=[
            Extension(
                # 扩展模块命名为_date，与date.py中的导入对应
                "_date",
                [os.path.join(DATE_PACKAGE_PATH, "date_wrap.cpp"), 
                 os.path.join(IRDLIB_PATH, "date.cpp")],
                include_dirs=[IRDLIB_PATH],
                depends=[os.path.join(IRDLIB_PATH, "date.hpp")],
            )
        ],
    )

3. 修正SWIG生成的date.py导入 #

SWIG自动生成的date.py中会有一行import _date，确保这行未带SWIG.date.前缀（调整setup后重新生成的date.py会自动修正）。

4. 重新安装并测试 #

• 执行pip uninstall date清理旧安装
• 回到setup.py所在目录，执行pip install -e .
• 在任意目录打开Python，执行import date测试是否成功

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