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"] 读取——但行为差异很大。
-
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)) 就能省掉半天排查。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
