MacOS Big Sur用Homebrew装Python3.9后Django导入错误怎么解决

• 验证虚拟环境解释器优先级
  激活虚拟环境后依次执行以下命令：

  which python3
  python3 --version
  

  确认返回的Python路径为当前虚拟环境目录下的bin/python3，而非brew全局路径/usr/local/bin/python3，避免虚拟环境未正确生效调用了全局Python环境。
• 校验虚拟环境内的Django安装状态
  激活虚拟环境后执行：

  pip3 list | grep Django
  python3 -c "import django; print(django.__file__)"
  

  首先确认Django版本与项目要求匹配，其次确认返回的Django安装路径处于当前虚拟环境的site-packages目录下，排除Django仅安装到全局环境未安装到虚拟环境的问题。
• 检查PYTHONPATH配置
  激活虚拟环境后执行echo $PYTHONPATH，确认项目根目录已包含在输出的路径列表中。如果未包含，可临时添加验证：

  export PYTHONPATH=/你的项目根目录绝对路径:$PYTHONPATH
  

  配置完成后再启动Django服务验证错误是否消失。
• 校验wsgi.py配置
  确认wsgi.py中没有硬编码全局Python路径，项目根目录拼接逻辑正确，os.path.append传入的是动态的项目路径而非固定的全局路径，同时检查settings.py中WSGI_APPLICATION参数的模块名拼写是否正确。
• 排除全局Python调用冲突
  执行ls -l /usr/local/bin/python3确认brew的Python3.9符号链接正常，后续操作统一使用python3、pip3命令，避免直接调用python、pip触发系统自带的Python2环境。

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