Mac下配置Python环境指向模块目录遇ModuleNotFoundError求助

核心原因 #

你把PYTHONPATH指向了modules目录本身，但Python需要从modules的父目录去查找这个包。当你写import modules.colors时，Python会在PYTHONPATH包含的路径下寻找名为modules的文件夹（作为包），然后再找里面的colors模块。

具体修复步骤 #

• 修改PYTHONPATH配置
  打开~/.zshrc，找到原来的PYTHONPATH配置行，把指向modules目录的路径改成它的父目录：

  # 原配置可能类似：
  # export PYTHONPATH="~/xxxxxxx/Development/Git/xxxxxx/modules/"
  # 修改为：
  export PYTHONPATH="~/xxxxxxx/Development/Git/xxxxxx/:$PYTHONPATH"
  

  加上:$PYTHONPATH是为了保留原有已配置的路径，避免覆盖。

• 刷新配置生效
  在终端执行命令，让.zshrc的修改立即生效：

  source ~/.zshrc
  

• 验证路径
  再次执行echo $PYTHONPATH，确认输出里包含~/xxxxxxx/Development/Git/xxxxxx/这个路径。

• 检查包标识文件
  确保modules目录下存在__init__.py文件（可以是空文件），这能让Python明确识别它为一个可导入的包。如果没有，直接创建：

  touch ~/xxxxxxx/Development/Git/xxxxxx/modules/__init__.py
  

• 测试脚本
  重新运行你的Python脚本，应该能正常导入modules下的各个模块了。

额外注意点 #

如果是用IDE（比如PyCharm、VS Code）运行脚本，IDE可能不会自动读取终端的PYTHONPATH配置，需要在IDE的项目设置里手动添加~/xxxxxxx/Development/Git/xxxxxx/到Python路径中。

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