load_dotenv() 必须在所有 os.getenv() 调用前执行，且需显式指定路径、确保 .env 语法正确（等号无空格、值含空格需引号）、手动类型转换，否则变量将不可用。
load_dotenv() 没在最前面调用
这是导致 os.getenv() 返回 None 的最高频原因。Python 进程启动后，环境变量快照就固定了；load_dotenv() 只是把 .env 文件内容写进 os.environ，它不回溯修改已执行过的代码逻辑。
常见错误写法：
import os
DB_URL = os.getenv("DATABASE_URL") # 此时 .env 还没加载，DB_URL 是 None
<p>from dotenv import load_dotenv
load_dotenv() # 太晚了，上面那行已经执行完了
</p>
正确做法：入口文件（如 main.py、app.py 或 manage.py）第一行导入 + 第二行调用：
from dotenv import load_dotenv-
load_dotenv()必须放在所有os.getenv()、配置初始化、数据库连接、框架实例化之前 - 如果用 Flask/FastAPI，不能只在某个路由函数里调用——得在创建
app实例前完成
.env 文件路径没找对
load_dotenv() 默认只查当前工作目录（os.getcwd()）下的 .env，不是代码文件所在目录。IDE 运行、Makefile 调用、Docker 启动时，工作目录很可能和你预期不一致。
验证方式：加一行调试输出
import os
print("Current working dir:", os.getcwd())
print(".env exists?", os.path.exists(".env"))
稳妥方案是显式传入路径：
- 用
__file__定位代码同级目录：load_dotenv(os.path.join(os.path.dirname(__file__), ".env")) - 或直接写绝对路径（适合 Docker/CI）：
load_dotenv("/app/.env") - 避免依赖
find_dotenv()——它向上遍历的逻辑在复杂项目结构里容易失效
.env 文件语法或内容有硬伤
python-dotenv 解析很严格，不符合规范的行会被跳过，且不报错。你看到变量“读不到”，实际可能是它根本没被解析。
必须遵守的规则：
- 等号两侧**不能有空格**：
KEY=value✅，KEY = value❌ - 不支持
export KEY=value或# 注释写在值后面：API_KEY=abc123 # dev❌（整行被忽略） - 值含空格、$、引号等特殊字符，**必须用引号包裹**：
NAME="John Doe"✅，NAME=John Doe❌（只会取到 John） - 变量名区分大小写，
db_url和DB_URL是两个变量
os.getenv() 拿到的是字符串，但你忘了类型转换
os.getenv() 永远返回 str 或 None。如果你直接拿它当布尔、整数或列表用，会出隐性 bug：
-
DEBUG = os.getenv("DEBUG")→ 即使 .env 里写的是DEBUG=true，DEBUG也是字符串"true"，不是True -
PORT = os.getenv("PORT")→ 得手动int(PORT)，否则uvicorn.run(..., port=PORT)会报类型错误 - 推荐写法：
debug = os.getenv("DEBUG", "False").lower() == "true"，port = int(os.getenv("PORT", "8000"))
生产环境尤其要注意：.env 里的值不会自动转类型，也永远不会是 None（除非变量根本不存在），你得自己兜底。
真正容易被忽略的点是：.env 加载成功 ≠ 变量可用。它只是把文本塞进 os.environ，后续所有类型处理、默认值 fallback、大小写校验、敏感信息脱敏，都得你自己写清楚——库只负责“搬运”，不负责“理解”。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
