在虚拟环境中安装Django后无法导入的问题求助

确认虚拟环境激活状态 #

• 查看终端提示符：激活成功后会显示虚拟环境名称（如(venv)前缀）
• 验证路径：执行which python（Linux/macOS）或where python（Windows），确认输出路径指向虚拟环境目录下的Python可执行文件

检查Django安装位置 #

• 激活虚拟环境后执行pip list，确认列表中存在Django
• 执行pip show django，查看安装路径是否为虚拟环境的lib/python3.12/site-packages目录，若路径指向全局Python，则说明Django未安装到虚拟环境内

排查PYTHONPATH干扰 #

• 执行echo $PYTHONPATH（Linux/macOS）或echo %PYTHONPATH%（Windows），若变量包含全局Python包目录路径，可能干扰虚拟环境包查找
• 临时清空PYTHONPATH测试：Linux/macOS执行unset PYTHONPATH，Windows执行set PYTHONPATH=，之后再尝试导入Django

适配Python 3.12的特殊处理 #

• 确认Django版本兼容性：仅Django 4.2.7+、5.0+版本支持Python 3.12，执行pip install --upgrade django升级到兼容版本
• 重新创建适配的虚拟环境：创建时指定Python 3.12，命令如下：

  # Linux/macOS
  rm -rf venv
  python3.12 -m venv venv
  source venv/bin/activate
  pip install django
  
  # Windows
  rmdir /s venv
  py -3.12 -m venv venv
  venv\Scripts\activate
  pip install django
  

IDE解释器配置检查 #

如果使用VS Code、PyCharm等IDE，需确认项目选中的Python解释器为虚拟环境内的Python，而非全局解释器

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