配置Python环境变量可提升Django项目的安全性与可维护性,避免敏感信息硬编码。推荐使用python-decouple或django-environ库从.env文件读取配置,或将系统环境变量通过os.environ注入,实现多环境灵活切换,同时应将.env加入.gitignore防止泄露。
在Django开发中,正确配置Python环境变量是确保项目正常运行的关键步骤。环境变量可用于管理数据库连接、密钥、调试模式等敏感或环境相关的信息,避免将这些信息硬编码到代码中。
使用环境变
量可以将配置与代码分离,提升安全性和可维护性。例如:SECRET_KEY、数据库密码、API密钥等不应写死在settings.py中。通过环境变量,可以在不同环境(开发、测试、生产)中灵活切换配置。
python-decouple是一个轻量级库,专门用于从外部文件中读取环境变量,简化配置管理。
pip install python-decouple
.env文件:.env 示例:
DEBUG=True SECRET_KEY=your-secret-key-here DATABASE_NAME=mydb DATABASE_USER=myuser DATABASE_PASSWORD=mypassword DATABASE_HOST=localhost DATABASE_PORT=5432
from decouple import config
DEBUG = config('DEBUG', default=False, cast=bool)
SECRET_KEY = config('SECRET_KEY')
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.postgresql',
'NAME': config('DATABASE_NAME'),
'USER': config('DATABASE_USER'),
'PASSWORD': config('DATABASE_PASSWORD'),
'HOST': config('DATABASE_HOST'),
'PORT': config('DATABASE_PORT', cast=int),
}
}
如果不引入第三方库,可以使用Python内置的os.environ来获取环境变量。
export DJANGO_DEBUG=True
set DJANGO_DEBUG=True
import os
DEBUG = os.environ.get('DJANGO_DEBUG', 'False').lower() == 'true'
SECRET_KEY = os.environ.get('DJANGO_SECRET_KEY', 'fallback-secret-key')
这种方法适合部署环境,如Docker或云服务器,通常通过系统级环境变量注入配置。
对于大型项目,django-environ更强大,支持多种格式和复杂的配置逻辑。
pip install django-environ
import environ
env = environ.Env()
environ.Env.read_env() # 读取 .env 文件
之后可用env('VAR_NAME')方式读取变量,支持类型转换,如env.bool('DEBUG')。
基本上就这些。选择合适的方法,把敏感信息移出代码,让Django项目更安全、更易部署。记得将.env加入.gitignore,防止泄露。