已通过pip3安装BDDexample模块却无法导入，求排查原因

这种明明通过pip确认模块已安装，却在导入时报错的情况确实很让人困惑，咱们结合你的环境一步步排查：

先确认你的环境信息 #

文件夹结构 #

root
|-setup.py
|-src
| |-BDDexample
| | |-ExampleSystem.py（包含ExampleSystem类）
| | |-__init__.py（空文件）
| |-tests
|-cucumber
|-features
|-steps
| |-EnableSystemStepImpl.py

原setup.py内容 #

#!/usr/local/bin/python3.6
from setuptools import setup, find_packages
setup(
    name="BDDexample",
    version="0.2",
    packages=find_packages()
)

你已经尝试过pip3 install .和先打包再安装的方式，pip3 list能看到模块，但在EnableSystemStepImpl.py中执行from BDDexample.ExampleSystem import ExampleSystem时报错。

可能的原因及解决步骤 #

1. Python环境不匹配（最常见的原因） #

你用pip3安装模块的Python环境，和运行EnableSystemStepImpl.py时使用的Python环境可能不是同一个：

• 打开终端，分别运行：

  which python3
  which pip3
  

  查看两个命令输出的路径是否一致。如果不一致，说明pip3把模块装到了另一个Python版本的环境里，而你运行脚本时用的是另一个Python解释器，自然找不到模块。
• 如果你使用了虚拟环境，一定要确保运行脚本前已经激活了对应的虚拟环境，否则会用系统默认的Python环境，而虚拟环境里安装的模块在系统环境中不可见。

2. setup.py配置有误，导致模块安装不完整 #

你的BDDexample包放在src目录下，但原setup.py中的find_packages()默认只会在setup.py所在的root目录下查找包，可能没有正确识别到src/BDDexample，导致安装的模块是空的或者不完整：

• 修改setup.py为以下内容：

  #!/usr/local/bin/python3.6
  from setuptools import setup, find_packages
  setup(
      name="BDDexample",
      version="0.2",
      package_dir={"": "src"},  # 指定包的根目录为src
      packages=find_packages(where="src")  # 在src目录下搜索所有包
  )
  

• 先卸载已安装的旧版本：

  pip3 uninstall -y BDDexample
  

• 重新安装模块：

  pip3 install .
  

• 验证安装是否正确：找到Python的site-packages目录（可以通过python3 -c "import site; print(site.getsitepackages())"查看），进入BDDexample文件夹，确认里面有ExampleSystem.py和__init__.py文件。

3. 运行脚本时的sys.path问题 #

如果上述两步都没问题，可以在EnableSystemStepImpl.py的最开头添加以下代码，查看Python的模块搜索路径：

import sys
print("当前Python的sys.path:")
for path in sys.path:
    print(path)

运行脚本后，检查输出中是否包含你的Python环境的site-packages目录。如果没有，说明运行脚本时的Python解释器没有加载默认的站点包路径，这种情况通常还是环境不匹配导致的。

4. Cucumber的Python解释器配置问题 #

如果是通过Cucumber运行step文件，需要确认Cucumber使用的Python解释器是否和你安装模块的python3一致。有些Cucumber配置会指定固定的Python路径，你可以检查Cucumber的配置文件（比如cucumber.yml），确保其中的Python路径和which python3输出的路径一致。

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