macOS虚拟机中运行Django遇ImportError问题求助

排查&解决步骤 #

• 激活虚拟环境：
  终端执行echo $VIRTUAL_ENV，无输出说明虚拟环境未激活。找到你的虚拟环境目录，执行source 你的虚拟环境名/bin/activate（示例：source venv/bin/activate）。
• 确认Django在当前环境已安装：
  激活环境后运行pip list，查看列表中是否有Django。若没有，直接执行pip install django重新安装。
• 检查PYTHONPATH配置：
  执行echo $PYTHONPATH，确认其包含Django的安装路径。若缺失，可临时添加：export PYTHONPATH=/你的虚拟环境/lib/pythonX.X/site-packages:$PYTHONPATH（替换为实际路径与Python版本），也可在虚拟环境的activate脚本中添加该行实现永久配置。
• 修正manage.py的解释器路径：
  打开manage.py，第一行的#!/usr/bin/env python可能指向系统全局Python，替换为虚拟环境内的Python路径，示例：#!/Users/xxx/venv/bin/python。

额外提醒 #

• 若项目存于虚拟机与宿主的共享文件夹中，建议移至虚拟机本地目录测试，共享路径可能引发依赖识别异常。
• 避免混用pip与pip3，确保使用虚拟环境自带的pip版本。

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