从Git安装自定义Python包calendarlib后模块导入失败求助

这种情况我之前踩过坑！问题出在本地运行和包安装后Python路径解析的差异上，你需要调整calendarlib包内的导入语句，而不是修改应用的导入方式。

本地运行main.py时，Python会把当前工作目录（也就是calendarlib的根目录）加入sys.path，所以你直接写import database能找到对应的子包。但当你通过pip安装后，calendarlib作为第三方包被放到site-packages目录下，此时Python只会识别calendarlib作为顶层包，直接import database就找不到了——因为database是calendarlib的子包，不是独立的顶层模块。

• 校准包内的导入语句
  把包内所有直接import database的地方，改成绝对导入或者相对导入：

  • 绝对导入（推荐，更清晰）：

    from calendarlib import database
    # 或者导入具体子模块
    from calendarlib.database import your_target_module
    

  • 相对导入（适合包内模块之间的内部引用）：
    如果是在calendarlib根目录下的模块（比如calendarlib/core.py）导入database子包，写成：

    from . import database
    # 或者导入具体子模块
    from .database import your_target_module
    

• 确保包结构和配置正确

  1. 确认database目录下有__init__.py文件（Python 3.3+虽支持无__init__.py的命名空间包，但为了兼容性和明确性，建议加上）。
  2. 检查你的包配置文件（比如setup.py或pyproject.toml），确保子包被正确包含：
     • 如果用setup.py，使用find_packages()自动发现所有子包：

       from setuptools import setup, find_packages
       
       setup(
           name="calendarlib",
           packages=find_packages(),
           # 其他版本、依赖等配置...
       )
       

     • 如果用pyproject.toml（现代Python包推荐），确保开启自动包发现：

       [tool.setuptools.packages.find]
       where = ["."]
       

• 用开发模式提前验证
  不要在包根目录直接运行测试，而是用开发模式安装包：

  pip install -e .
  

  然后切换到其他目录（比如你的用户应用目录）运行代码，这样能模拟实际安装后的环境，提前发现问题。

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