如何解决ModuleNotFoundError: No module named 'config.settings'错误？

• 检查项目目录结构
  确保项目根目录下存在config文件夹，且文件夹内包含settings.py和空的__init__.py文件（Python需要这个文件识别该文件夹为可导入的包）。正确的结构示例：

  your_project/
  ├── config/
  │   ├── __init__.py
  │   ├── settings.py
  │   ├── urls.py
  │   └── wsgi.py
  ├── manage.py
  

  如果缺少__init__.py，直接在config文件夹里创建一个空文件即可。

• 核对manage.py中的settings路径
  打开项目根目录下的manage.py，找到以下代码行：

  os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'config.settings')
  

  确保第二个参数是'config.settings'，如果路径不符，修改为你的settings文件实际所在的模块路径。

• 排查环境变量干扰
  终端中运行对应命令，查看是否有环境变量覆盖了Django的settings路径：

  # Linux/macOS
  echo $DJANGO_SETTINGS_MODULE
  # Windows
  echo %DJANGO_SETTINGS_MODULE%
  

  如果输出不是config.settings，清空该环境变量后再重新运行命令。

• 确认虚拟环境已激活
  运行python manage.py命令前，确保你已经激活了项目对应的虚拟环境：

  # Linux/macOS
  source venv/bin/activate
  # Windows
  venv\Scripts\activate
  

  激活后再执行python manage.py runserver或migrate命令。

• 验证项目根目录在Python路径中
  在manage.py开头添加以下代码，运行后查看输出：

  import sys
  print(sys.path)
  

  如果输出中没有项目根目录（即manage.py所在的目录），在manage.py中添加路径：

  import os
  import sys
  sys.path.append(os.path.dirname(os.path.abspath(__file__)))
  

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