从Git仓库安装的Python包导入类报错ModuleNotFoundError求助

问题回顾 #

导入自定义包时出现错误：

ModuleNotFoundError: No module named 'myutility.utilities'

包已通过python3 -m pip install git+[myutility仓库地址]@[分支名]成功安装，目录结构如下：

myutility
    - utilities
        databases.py（包含PostgresInteract类）

setup.py配置：

from setuptools import setup
setup(name='myutility',
      version='1.0',
      packages=['myutility','myutility.utilities']

各目录均包含__init__.py文件。

排查与解决步骤 #

1. 确认Python环境与包安装路径匹配 #

• 执行python3 -m pip show myutility查看包的安装位置，重点关注输出中的Location字段。
• 在运行导入的脚本中添加以下代码，确认安装路径在Python的搜索路径中：

  import sys
  print(sys.path)
  

• 检查是否使用了虚拟环境，确保安装包和运行脚本的是同一个环境（需先激活虚拟环境再操作）。

2. 优化setup.py的包配置 #

手动声明包容易遗漏或出错，建议改用find_packages()自动发现所有子包：

from setuptools import setup, find_packages
setup(
    name='myutility',
    version='1.0',
    packages=find_packages()
)

3. 修正__init__.py的导出配置 #

若要直接通过from myutility.utilities import PostgresInteract导入，需在myutility/utilities/__init__.py中添加：

from .databases import PostgresInteract

如果不需要直接导出，确保使用完整路径导入时类名拼写正确（注意大小写）：

from myutility.utilities.databases import PostgresInteract

4. 重新安装并验证 #

• 先卸载旧包：

  python3 -m pip uninstall -y myutility
  

• 重新安装并查看详细日志，确认包正确部署：

  python3 -m pip install -v git+[仓库地址]@[分支名]
  

• 进入Python交互环境测试导入，验证是否成功：

  # 测试导入
  from myutility.utilities import PostgresInteract
  # 或
  from myutility.utilities.databases import PostgresInteract
  

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