本文介绍如何使用 python-dotenv 根据命令行指定的环境名称（如 qa、staging、prod）自动加载对应 .env.{env} 文件，实现多环境配置管理，无需硬编码路径或额外设置模块。
本文介绍如何使用 python-dotenv 根据命令行指定的环境名称（如 qa、staging、prod）自动加载对应 .env.{env} 文件，实现多环境配置管理，无需硬编码路径或额外设置模块。
在实际项目中，不同部署环境（如开发、测试、预发布、生产）往往需要隔离配置。python-dotenv 本身不内置多环境切换机制，但可通过组合系统环境变量与命令行参数，实现简洁、可扩展的多环境加载方案。
✅ 推荐实践：通过 ENVIRONMENT 环境变量动态加载
最轻量且符合 Unix 哲学的方式是利用操作系统环境变量控制加载逻辑。你无需修改 python-dotenv 源码，也不必编写独立 settings 模块，只需在启动脚本时传入环境标识即可：
# 加载 .env.qa ENVIRONMENT=qa python test.py # 加载 .env.staging ENVIRONMENT=staging python test.py # 加载 .env.prod ENVIRONMENT=prod python test.py
对应 Python 脚本（test.py）如下：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
import os
from dotenv import load_dotenv
from pathlib import Path
# 1. 获取环境名，默认为 'development'
env_name = os.getenv('ENVIRONMENT', 'development')
# 2. 构建对应 .env 文件路径（支持当前目录或自定义目录）
dotenv_path = Path(f'.env.{env_name}')
# ✅ 关键：仅当文件存在时才加载，避免静默失败
if dotenv_path.exists():
load_dotenv(dotenv_path)
print(f"✅ Loaded environment variables from {dotenv_path}")
else:
print(f"⚠️ Warning: {dotenv_path} not found. Using default environment or system variables.")
# 3. 读取配置（支持 fallback 或报错提示）
host = os.getenv('HOST')
if not host:
raise ValueError("Missing required environment variable: HOST")
print(f"HOST = {host}")
? 目录结构建议（清晰可维护）
project/ ├── .env.development # 默认开发配置 ├── .env.qa # 测试环境 ├── .env.staging # 预发布环境 ├── .env.prod # 生产环境 ├── test.py # 主程序 └── README.md
? 提示：.env.* 文件应加入 .gitignore，防止敏感配置泄露；推荐使用 .env.example 作为模板提交至仓库。
⚠️ 注意事项与最佳实践
- 不要依赖 load_dotenv() 的默认行为：它只加载 .env，不识别 .env.* —— 必须显式传入 dotenv_path。
- 路径安全校验很重要：使用 Path.exists() 判断文件是否存在，避免因路径错误导致配置未加载却无提示。
-
环境变量优先级：os.getenv() 总是优先返回已存在的系统环境变量（如 shell 中 export HOST=xxx），.env 文件仅作为 fallback。如需强制覆盖，请在 load_dotenv() 中设置 override=True：
load_dotenv(dotenv_path, override=True) # 覆盖已存在的同名变量
-
命令行参数替代方案（进阶）：若需更明确的 CLI 控制（如 python test.py --env prod），可结合 argparse 实现：
import argparse parser = argparse.ArgumentParser() parser.add_argument('--env', default='development') args = parser.parse_args() dotenv_path = Path(f'.env.{args.env}') load_dotenv(dotenv_path)
通过以上方式，你既能保持代码简洁性，又能实现生产就绪的多环境配置管理——无需第三方扩展，仅用 python-dotenv 原生能力即可稳健支撑 CI/CD 流程。
