Django crispy_forms报ModuleNotFoundError，多种安装尝试仍未解决

问题核心 #

你用PyCharm启动项目时触发ModuleNotFoundError: No module named 'crispy_forms'，但终端运行python3 manage.py runserver却正常——本质是PyCharm配置的Python解释器和终端使用的环境不一致，导致你安装的django-crispy-forms不在PyCharm加载的环境里。

解决步骤 #

1. 确认终端的Python解释器路径

• Windows终端运行：where python3
• Linux/macOS终端运行：which python3
  记下输出的路径（比如C:\Python310\python.exe或/usr/local/bin/python3）。

2. 同步PyCharm的Python解释器

1. 打开PyCharm，依次点击 File > Settings > Project: [你的项目名] > Python Interpreter
2. 点击右上角齿轮图标，选择Add
3. 选择System Interpreter，找到刚才终端输出的Python路径并选中，点击OK
4. 等待环境加载完成，检查解释器列表里是否有django-crispy-forms包

3. 验证修复

重启PyCharm的运行配置，点击右上角运行按钮，报错应该会消失。

额外排查点 #

• 如果用了虚拟环境（比如venv、pipenv）：
  • 先激活虚拟环境，再运行pip install django-crispy-forms
  • 在PyCharm的解释器设置里，选择虚拟环境对应的Python路径（比如venv/bin/python或venv\Scripts\python.exe）
• 确认settings.py里的配置正确：

  INSTALLED_APPS = [
      # ... 其他app
      'crispy_forms',
      'crispy_uni_form',  # 新版crispy-forms需添加此配置才能用uni_form模板
  ]
  CRISPY_TEMPLATE_PACK = 'uni_form'
  

报错详情引用 #

File "C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.10_3.10.2544.0_x64__qbz5n2kfra8p0\lib\importlib_init_.py", line 126, in import_module
return _bootstrap._gcd_import(name[level:], package, level)
File "", line 1050, in _gcd_import
File "", line 1027, in _find_and_load
File "", line 1004, in _find_and_load_unlocked
ModuleNotFoundError: No module named 'crispy_forms'

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