怎样在Python中使用Dotenv管理项目的敏感环境变量-Python教程-PHP中文网

load_dotenv() 默认不生效的主因是路径错误、加载时机不当或系统变量覆盖；须确保在进程启动前调用、指定正确 dotenv_path、禁用自动搜索，并用 os.getenv() 安全读取。

怎样在python中使用dotenv管理项目的敏感环境变量

load_dotenv()

默认就能解决绝大多数敏感变量加载问题，但必须配合正确的路径、加载时机和默认值策略，否则会静默失败或读错值。

为什么 `load_dotenv()` 没生效？常见静默失败原因

它不报错，但 os.getenv("API_KEY") 返回 None——这是最常被忽略的坑。

.env 文件没放在 load_dotenv() 执行时的“项目根目录”：该函数默认只在当前工作目录（os.getcwd()）及其父目录向上递归查找，不是脚本所在目录
Python 进程已启动后才调用 load_dotenv()：比如在某个子模块里 late import + load，此时主程序可能早已读过 os.environ 缓存
系统环境变量已存在同名键：例如服务器上设置了 DEBUG=0，而你的 .env 里是 DEBUG=True，默认规则是「系统变量优先」，不会覆盖
.env 文件编码不是 UTF-8（无 BOM）：含中文或特殊字符时，解析直接跳过整行，不提示

多环境配置必须用 `dotenv_path` 显式指定

开发、测试、生产共用一套代码，靠切换文件而非改代码。硬编码路径易出错，推荐结合 pathlib 构造：

from pathlib import Path
from dotenv import load_dotenv

env_file = Path(__file__).parent / "config" / ".env.production"
if env_file.exists():
    load_dotenv(dotenv_path=env_file)
else:
    load_dotenv(dotenv_path=Path(__file__).parent / ".env")

不要依赖 find_dotenv() 自动搜索：它在打包成可执行文件（PyInstaller）或某些容器中会失效
避免把 .env.production 提交到 Git：只保留 .env.example 作为模板
生产环境建议禁用 .env 文件，强制走系统环境变量（运维统一管控），这时 load_dotenv(override=False) 是安全底线

`os.getenv()` 和 `os.environ[]` 的关键区别

读取方式选错，会导致程序崩溃或逻辑错乱：

Biopython

全面的分子生物学工具集。适用于序列操作、文件解析（FASTA/GenBank/PDB）、系统发育分析，以及通过 Bio.Entrez 以编程方式访问 NCBI/

下载

os.getenv("DB_PORT", 5432)：安全，返回默认值 5432（注意类型是 str，需手动转 int）
os.environ["DB_PORT"]：危险，键不存在直接抛 KeyError，线上服务可能启动失败
os.environ.get("DEBUG", "False").lower() == "true"：布尔值不能靠字符串相等判断，python-dotenv 不自动转换类型，必须自己处理