如何在Python中通过.env文件隔离开发与生产环境配置？-Python教程-PHP中文网

python不原生支持.env文件加载，直接用open()手动解析易出错，根本原因是未按dotenv规范处理注释、引号、变量扩展等；正确做法是使用python-dotenv库的load_dotenv()在入口文件顶部显式加载，并注意路径、编码及类型转换。

如何在python中通过.env文件隔离开发与生产环境配置？

为什么直接读取 `.env` 文件容易出错？

Python 本身不原生支持 .env 文件加载，很多人用 open() 手动读取再 os.environ.update()，结果发现变量没生效、类型全是字符串、注释被当成键名、甚至路径中空格导致解析断裂。根本原因是：没有按 dotenv 格式规范解析——比如忽略 # 开头的行、处理引号包裹的值、展开 ${VAR} 变量引用。

正确做法是交给成熟库处理，推荐 python-dotenv（非 dotenv，后者已弃用）：

pip install python-dotenv

它会严格遵循 dotenv 官方规则，包括空行跳过、单双引号内保留空格、反斜杠转义等。

`load_dotenv()` 的调用时机和位置很关键

环境变量必须在任何依赖它们的代码执行前加载，否则 os.getenv("DB_URL") 会返回 None。常见错误是把 load_dotenv() 放在模块末尾、或只在 main() 里调用，但 Django/Flask 启动时已提前读取配置。

最稳妥位置：项目入口文件顶部（如 app.py 或 manage.py 第一行 import 后）
开发环境可显式指定路径：load_dotenv(".env.development")；生产环境通常不传参，默认找 .env
避免重复加载：加 override=False（默认值），防止本地 .env 覆盖系统级环境变量
Django 用户注意：不能在 settings.py 顶部就调用，需确保 os 已导入且早于所有配置读取逻辑

如何安全区分开发与生产配置？

不要在代码里写 if os.getenv("ENV") == "prod" 去切换数据库地址——这会让敏感配置混入版本库。正确隔离方式是：

提交一个最小化的 .env.example（不含密钥），包含所有必需变量名和注释说明
Git 忽略真实 .env 和 .env.production，靠 CI/CD 注入生产环境变量
本地开发用 .env.development，通过 load_dotenv(".env.development") 加载
若需多层覆盖（如通用 + 环境专属），按顺序多次调用 load_dotenv()，后加载的优先级更高

示例目录结构：

Python 3.14.2

Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。

下载

.env.example
.env.development
.env.production  # 不提交

此时 load_dotenv(".env.development") 会加载开发专用值，而 os.getenv("DEBUG", "False") 默认值能兜底防报错。

为什么 `os.getenv()` 直接取值仍可能出问题？

python-dotenv 只负责把文件内容塞进 os.environ，但 os.getenv() 返回的永远是字符串，不会自动转布尔或整数。比如 DEBUG=true 在文件里，os.getenv("DEBUG") == "true" 才为真，bool(os.getenv("DEBUG")) 却恒为 True（非空字符串）。

建议封装一层类型转换：

from dotenv import load_dotenv
import os
<p>load_dotenv()
DEBUG = os.getenv("DEBUG", "False").lower() == "true"
PORT = int(os.getenv("PORT", "8000"))
SECRET_KEY = os.getenv("SECRET_KEY")  # 必须存在，不设默认值</p>

更严谨的做法是用 pydantic-settings 或自定义配置类做校验，但对小项目，手动 int()/float()/json.loads() 已足够。

真正容易被忽略的是：.env 文件编码必须是 UTF-8 无 BOM，Windows 记事本保存时容易带 BOM，会导致第一行变量读取失败——用 VS Code 或 Notepad++ 显式另存为 UTF-8 编码再试。