Linux环境下使用venv导入自定义modules包失败问题排查

1. 确认虚拟环境是否正确激活 #

你可能在运行测试脚本时未激活对应的venv环境，导致系统使用全局Python解释器而非虚拟环境内的版本，而全局环境并未安装你的modules包。

• 解决：运行脚本前先激活虚拟环境：

  source .venv/bin/activate
  

  激活后再执行测试脚本：

  python devel/devel_modules1/someTest.py
  

2. 检查setup.py的配置是否正确 #

开发模式安装生效的核心是setup.py的包结构配置正确，否则即使安装成功，Python也无法识别包路径。

• 确保setup.py中name字段设为modules，并通过find_packages()自动识别所有子包：

  from setuptools import setup, find_packages
  
  setup(
      name="modules",
      version="0.1",
      packages=find_packages(),
  )
  

• 若手动指定packages，需包含所有需要导入的子模块：

  packages=["modules", "modules.modules1", "modules.modules2", "modules.modules3"]
  

• 重新执行开发模式安装：

  pip install -e modules
  

3. 验证包是否安装到虚拟环境 #

可能因pip指向全局环境，导致包未安装到venv中。

• 激活venv后执行pip list，确认modules包在列表中，且路径显示为你的项目modules目录（开发模式安装会显示类似modules @ file:///path/to/your/project/modules）。
• 若不在列表中，直接调用虚拟环境的pip重新安装：

  .venv/bin/pip install -e modules
  

4. 检查测试脚本的运行方式 #

若直接用全局Python解释器运行脚本，会跳过虚拟环境的包配置。

• 错误示例：/usr/bin/python3 devel/devel_modules1/someTest.py
• 正确做法：激活venv后用python命令，或直接调用虚拟环境的解释器：

  .venv/bin/python devel/devel_modules1/someTest.py
  

5. 确认modules目录结构符合Python包规范 #

确保你的目录结构如下（每个子目录必须包含__init__.py，可以是空文件）：

project_root/
├── .venv/
├── devel/
│   ├── devel_modules1/
│   │   └── someTest.py
│   ├── devel_modules2/
│   └── devel_modules3/
└── modules/
    ├── __init__.py
    ├── setup.py
    ├── modules1/
    │   ├── __init__.py
    │   └── fileModules1.py
    ├── modules2/
    │   └── __init__.py
    └── modules3/
        └── __init__.py

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