Mac环境下modAL-python包ModuleNotFoundError问题排查求助

1. 确认Python解释器与环境匹配 #

• 激活pipenv环境后，执行which python获取当前环境的Python路径
• 执行python -c "import sys; print(sys.path)"查看当前Python的模块搜索路径
• 执行pip show modAL-python，查看输出中的Location字段，确认该路径是否存在于上述sys.path列表中
  • 若不存在，说明当前使用的Python解释器未关联pipenv环境，改用pipenv run python直接运行代码，而非先激活shell再执行

2. 检查模块名称大小写 #

• 确认代码中的导入语句是from modAL.models import ActiveLearner，而非拼写错误的modAl（注意A是大写）
• 查看pipenv环境的site-packages目录：通过pip show modAL-python | grep Location获取路径，进入该路径查看模块文件夹实际名称是否为modAL
  • Mac文件系统默认大小写不敏感，但Python模块导入严格区分大小写，必须保证代码中的模块名与实际文件夹名完全一致

3. 重建pipenv环境依赖 #

• 删除Pipfile.lock文件，重新执行pipenv install，确保依赖安装过程无报错
• 激活环境后，直接执行python -c "from modAL.models import ActiveLearner; print('导入成功')"，验证基础导入是否正常
• 若仍失败，强制重新安装目标包：pipenv install modAL-python==0.4.2.1

4. 排查全局环境干扰 #

• 激活pipenv shell后，执行pip --version，确认输出的pip路径属于当前pipenv环境，而非全局Python环境
• 改用pipenv run pip list查看环境内依赖，避免全局环境的pip输出干扰判断

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