Django设置分离：开发与生产环境配置技巧

本文深入剖析了 Django 项目中环境配置管理的核心痛点与最佳实践，强调必须摒弃在单一 settings.py 中通过 if DEBUG 或文件存在性判断等脆弱方式区分环境，转而采用清晰、可维护的多文件分离策略——以 base.py 抽取通用配置，development.py 和 production.py 各自专注环境特异性设置，并严格依赖 DJANGO_SETTINGS_MODULE 在 Django 初始化前精准指定；同时反复警示敏感信息（如 SECRET_KEY、数据库凭证）绝不能硬编码，必须通过环境变量或 Kubernetes Secret 等安全机制动态注入，避免 CI/CD 泄露与线上安全隐患；文章不仅给出结构化方案，更直击落地难点：配置变更时的责任归属、生效验证和常见陷阱（如 Gunicorn 不读 .env、Docker 网络下 INTERNAL_IPS 配置失误、SECURE_* 开关遗漏等），帮助开发者构建真正健壮、可审计、团队友好的配置管理体系。

用 settings.py 做环境判断容易出错

直接在 settings.py 里写 if DEBUG: 或读取 os.environ 判断环境，短期看着省事，但很快会失控——比如某天你发现生产环境也加载了开发用的 django-debug-toolbar，或者数据库密码被硬编码进 Git。

• 环境变量读取要早于 Django 初始化，否则 DEBUG、DATABASE_URL 等关键配置可能失效
• DEBUG=True 在生产环境启用会暴露敏感路径和变量名，Nginx 日志里都可能漏出堆栈
• 别用文件存在性判断（如 if os.path.exists('prod.py'):），Docker 容器里路径容易错位

推荐做法：按环境拆成多个 settings 文件 + 公共基类

把通用配置抽到 base.py，再分别建 development.py 和 production.py，每个只覆盖差异项。启动时通过 DJANGO_SETTINGS_MODULE 指定。

• base.py 放 INSTALLED_APPS、中间件骨架、静态文件基础路径等不随环境变的内容
• production.py 必须重写 SECRET_KEY（从环境变量读，绝不用默认值）、DEBUG=False、ALLOWED_HOSTS、SECURE_* 系列开关
• development.py 可以加 'debug_toolbar'，但记得检查 INTERNAL_IPS 是否匹配容器网络 IP（比如 Docker 中常是 '172.17.0.1'）

DJANGO_SETTINGS_MODULE 设置时机和常见陷阱

这个环境变量必须在 Django 加载前就生效，否则它会 fallback 到默认的 settings.py，你写的分离逻辑就白搭。

• 命令行启动时，用 DJANGO_SETTINGS_MODULE=myproject.settings.production python manage.py runserver ——注意顺序，变量要在 python 前置
• Gunicorn 启动时，加 --env DJANGO_SETTINGS_MODULE=myproject.settings.production，别只靠 .env 文件，Gunicorn 不自动读它
• 如果用了 python-decouple 或 django-environ，它们只是帮你读环境变量，不替代 DJANGO_SETTINGS_MODULE 的作用

敏感配置别进代码，用环境变量或 secrets backend

SECRET_KEY、数据库密码、API 密钥这些，一旦写死在 production.py 里，CI/CD 流水线或镜像构建时就可能泄露。

• 用 os.environ.get('SECRET_KEY') 读取，启动容器时通过 -e SECRET_KEY=xxx 注入
• K8s 环境优先用 Secret 挂载为文件，然后在 production.py 中用 open('/run/secrets/django_secret').read().strip()
• 避免在 base.py 里给敏感字段设默认值（如 SECRET_KEY = os.environ.get('SECRET_KEY', 'dev-key-for-local')），生产部署时容易忘记删掉默认值

环境拆分最难的不是结构，是让所有人（包括你自己下周）都记得每次改配置时，到底该动哪个文件、往哪加环境变量、在哪验证是否生效。漏掉一个 SECURE_HSTS_SECONDS 或多写一个逗号导致 ALLOWED_HOSTS 解析失败，线上就挂。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Django设置分离：开发与生产环境配置技巧》文章吧，也可关注golang学习网公众号了解相关技术文章。