已安装django-storages仍出现ModuleNotFoundError的问题求助

可能原因及解决方案 #

1. Python解释器与pip不匹配（Windows环境常见） #

激活虚拟环境后，你使用的python3可能指向全局Python，而非虚拟环境内的解释器，导致找不到虚拟环境中安装的包。

解决步骤：

• 激活虚拟环境后，执行以下命令确认路径一致性：

  where python
  where pip
  

  两个命令的输出都应该指向houseVenv\Scripts目录下的可执行文件。
• 如果不一致，改用虚拟环境内的python命令（而非python3）运行项目：

  python manage.py runserver
  

• 同时，用pip而非pip3安装包，确保对应虚拟环境：

  pip install django-storages
  

2. django-storages未实际安装到虚拟环境（pip缓存或安装异常） #

虽然pip list显示已安装，但实际storages模块并未出现在虚拟环境的site-packages目录中。

解决步骤：

• 打开虚拟环境的site-packages目录（路径类似C:\path\to\houseVenv\Lib\site-packages），检查是否存在storages文件夹和django_storages-1.14.4.dist-info文件夹。
• 如果不存在，强制重新安装并清除缓存：

  pip uninstall -y django-storages
  pip install --no-cache-dir django-storages
  

3. 虚拟环境损坏 #

虚拟环境可能因权限问题、文件损坏等导致包无法被正确识别。

解决步骤：

• 彻底重建虚拟环境：

  # 退出当前虚拟环境
  deactivate
  # 删除旧虚拟环境文件夹
  rmdir /s houseVenv
  # 创建新虚拟环境
  python3 -m venv houseVenv
  # 激活新虚拟环境
  houseVenv\Scripts\activate
  # 重新安装所有依赖（包括Django和django-storages）
  pip install django django-storages
  

4. 手动导入测试时的解释器错误 #

你手动导入时可能使用了全局Python而非虚拟环境内的解释器。

解决步骤：

• 激活虚拟环境后，执行python（而非全局的python3）进入交互模式，再尝试import storages：

  (houseVenv) PS C:\path\to\project> python
  >>> import storages
  >>> # 无报错则说明模块正常
  

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