load_dotenv() 默认不生效的主因是路径错误、加载时机不当或系统变量覆盖；须确保在进程启动前调用、指定正确 dotenv_path、禁用自动搜索，并用 os.getenv() 安全读取。
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[] 的关键区别
读取方式选错，会导致程序崩溃或逻辑错乱：
-
os.getenv("DB_PORT", 5432)：安全，返回默认值5432（注意类型是str，需手动转int） -
os.environ["DB_PORT"]：危险，键不存在直接抛KeyError，线上服务可能启动失败 -
os.environ.get("DEBUG", "False").lower() == "true"：布尔值不能靠字符串相等判断，python-dotenv不自动转换类型，必须自己处理
敏感变量泄露的两个隐蔽入口
即使用了 .env，仍可能意外暴露密钥：
立即学习“Python免费学习笔记（深入）”；
- 日志打印完整
os.environ：调试时写print(os.environ)会吐出所有键值，包括API_KEY - 异常 traceback 泄露：某些框架（如 Flask 开发模式）会在错误页显示环境变量，务必关掉
debug=True上生产 -
.env文件权限太宽：Linux/macOS 下运行chmod 600 .env，防止同服务器其他用户读取
load_dotenv() 本身足够轻量，但真正决定安全的是你控制加载路径、覆盖逻辑和读取方式的那几行代码——它们比任何文档都更早被执行，也更容易被忽略。 
