使用Poetry安装本地包时遇ModuleNotFoundError问题求助

核心问题 #

本地直接运行helloWorld.py时，Python会把当前脚本所在目录加入sys.path，所以能直接找到同级的pk1模块；但包安装后，helloWorld.py属于mypackage_test包的一部分，此时导入路径需要遵循包内的层级关系，原导入语句没有适配这种结构，导致找不到模块。

解决步骤 #

1. 修正helloWorld.py的导入语句 #

将原导入（比如import pk1.mypack或from pk1 import xxx）改为以下两种方式之一：

• 相对导入（推荐，符合包内模块引用规范）：

  from .pk1 import mypack
  # 若需调用mypack内函数，可写为：from .pk1.mypack import your_function
  

• 绝对导入（明确指定完整包路径）：

  from mypackage_test.pk1 import mypack
  

2. 验证本地运行（可选但推荐） #

用包模块的方式运行脚本，避免直接运行单个文件导致的路径问题：

python -m mypackage_test.helloWorld

如果运行正常，说明导入逻辑没问题。

3. 重新打包并安装 #

执行以下命令更新包：

poetry build
pip install --upgrade dist/mypackage_test-*.whl  # 也可使用对应的tar.gz文件

4. 检查pyproject.toml的包配置（若上述步骤无效） #

确保pyproject.toml中正确声明了要打包的包，Poetry默认会自动识别子包，若有特殊结构可显式配置：

[tool.poetry]
# 其他配置项...
packages = [{ include = "mypackage_test" }]

该配置会确保mypackage_test目录下的所有子包（包括pk1）都被打包进去。

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