load_dotenv()没生效的主因是路径错误或调用时机不当：必须在读取环境变量前显式调用，并指定正确路径（如load_dotenv(".env")），否则默认仅加载当前工作目录下的.env文件。

为什么 load_dotenv() 没生效？路径和调用时机最关键

绝大多数问题不是库坏了，而是 load_dotenv() 没在正确位置、正确时间被调用。它不会自动扫描项目根目录，也不会递归向上找 .env 文件。

• 必须在读取环境变量（比如 os.getenv("DB_URL")）之前调用 load_dotenv()
• 默认只加载当前工作目录（os.getcwd()）下的 .env 文件；如果项目结构是 src/main.py，而 .env 在项目根目录，那直接调用会失败
• 推荐显式传入路径：load_dotenv(".env") 或 load_dotenv(Path(__file__).parent / ".env")
• 不要放在模块底部或函数里延迟加载——环境变量通常在模块导入时就要可用

dotenv_path 和 override 参数怎么选？

dotenv_path 控制从哪读，override 控制是否覆盖已存在的环境变量。这两个参数不设好，会导致本地配置被系统环境“劫持”或完全失效。

• dotenv_path 接收字符串或 Path 对象；常见写法：load_dotenv(".env.local")（用于本地覆盖）、load_dotenv(find_dotenv())（需先 pip install python-dotenv，配合 find_dotenv() 向上查找）
• override=False（默认）：只设置未定义的环境变量；已有值（如系统级 ENV=prod）不会被 .env 里的 ENV=dev 覆盖
• override=True：强制用 .env 的值覆盖所有同名变量；适合开发环境彻底隔离系统配置
• 注意：override=True 不影响子进程继承的变量，仅作用于当前 Python 进程

读不到变量？检查这三件事

不是代码写错，而是文件格式、编码或权限挡在前面。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

• .env 文件必须是 UTF-8 编码（无 BOM），Windows 记事本保存时容易带 BOM，建议用 VS Code 或 Notepad++ 重存
• 变量定义不能有空格（KEY = value ❌），正确写法是 KEY=value（等号紧贴）；注释用 # 开头，且必须独占一行或位于行尾
• 确保文件名就是 .env（不是 .env.txt），macOS/Windows 资源管理器可能隐藏扩展名；用终端 ls -a 或 dir /a 确认
• 如果用 IDE 运行（如 PyCharm），检查运行配置里的 “Working directory” 是否与 .env 所在目录一致

和 os.environ、os.getenv() 混用要注意什么？

load_dotenv() 只是把 .env 写进 os.environ 字典，后续仍靠 os.getenv() 或 os.environ["KEY"] 读取——但行为差异很大。

立即学习“Python免费学习笔记（深入）”；

• os.getenv("MISSING", "default") 安全，返回默认值；os.environ["MISSING"] 直接抛 KeyError
• os.environ 是实时字典，修改它会影响后续所有读取（包括第三方库），但不写回磁盘；load_dotenv() 只执行一次，不会监听文件变化
• 不要在 load_dotenv() 前就访问 os.environ ——此时 .env 还没加载，你看到的是干净的系统环境
• 调试时可打印 dict(os.environ) 快速确认变量是否真进来了

实际项目里最常卡住的，是以为 load_dotenv() 会“自动发现并加载”，结果它安静地失败了，还一声不吭。多打一行 print("Loaded:", load_dotenv(override=True)) 就能省掉半天排查。