如何设置DJANGO_SETTINGS_MODULE？解决Django配置异常报错

先搞定EMAIL_BACKEND报错的核心原因 #

这个报错本质是Django找不到正确的配置文件（settings.py），或者配置文件里的EMAIL_BACKEND配置有问题。先确保你能让Django定位到正确的settings文件，再检查具体配置。

DJANGO_SETTINGS_MODULE的正确设置方式 #

这个环境变量的作用是告诉Django：“我要使用哪个settings配置文件”，格式是项目包名.settings（比如你的项目叫myproject，就是myproject.settings），下面是几种常用设置方法：

1. 使用Django官方命令时（推荐新手） #

如果你用python manage.py runserver、python manage.py migrate这类官方命令，默认不需要手动设置——只要你的项目结构是标准的（manage.py和项目包文件夹同级），Django会自动找到项目包名.settings这个配置文件。

如果你的项目结构特殊（比如自定义了多环境settings），可以在命令后加参数指定：

python manage.py runserver --settings=myproject.settings.dev

2. 终端临时设置环境变量 #

激活虚拟环境后，在当前终端里直接设置，仅对当前会话有效：

• Linux/macOS：

  export DJANGO_SETTINGS_MODULE=myproject.settings
  

• Windows cmd：

  set DJANGO_SETTINGS_MODULE=myproject.settings
  

• Windows PowerShell：

  $env:DJANGO_SETTINGS_MODULE="myproject.settings"
  

3. 永久设置到虚拟环境的activate文件 #

你之前尝试的方法没效果，大概率是路径格式写错了，或者没重新激活虚拟环境。正确步骤：

1. 找到虚拟环境文件夹：比如你创建的虚拟环境叫venv，路径就是项目根目录/venv
2. 找到activate文件：
   • Linux/macOS：venv/bin/activate（bash脚本）
   • Windows：venv/Scripts/activate.bat（cmd用）或venv/Scripts/Activate.ps1（PowerShell用）
3. 打开activate文件，在末尾添加一行：
   • Linux/macOS：export DJANGO_SETTINGS_MODULE=myproject.settings
   • Windows（bat）：set DJANGO_SETTINGS_MODULE=myproject.settings
   • Windows（ps1）：$env:DJANGO_SETTINGS_MODULE="myproject.settings"
4. 保存文件，关闭当前终端，重新激活虚拟环境，设置才会生效。

4. 在自定义Python脚本中设置 #

如果你写了自己的Python脚本需要调用Django功能，要在脚本开头先指定settings模块：

import os
# 替换成你的项目settings路径
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings')
import django
django.setup()

# 之后就可以正常使用Django的模型、功能了

最后检查EMAIL_BACKEND配置 #

当Django能找到settings文件后，打开settings.py，确保EMAIL_BACKEND有正确设置，默认值是：

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'

如果暂时不需要发邮件，也可以用测试后端避免报错：

EMAIL_BACKEND = 'django.core.mail.backends.dummy.EmailBackend'

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