`os.getenv()` 是 Python 标准库 `os` 模块中用于**安全获取环境变量值**的函数。它从操作系统的环境变量中读取指定名称的变量，如果该变量存在则返回其字符串值；如果不存在，则默认返回 `None`（也可通过第二个参数指定默认值）。 --- ### ✅ 基本语法： ```python import os value = os.getenv(key, default=None) ``` - `key`（必需）：字符串，表示环境变量的名称（如 `"PATH"`、`"HOME"`、`"DATABASE_URL"`）。 - `default`（可选）：当环境变量未定义时返回的默认值（默认为 `None`）。 > ⚠️ 注意：`os.getenv()` **不会抛出异常**（即使变量不存在），这与 `os.environ[key]`（直接访问会触发 `KeyError`）形成关键区别，因此更推荐在不确定变量是否存在时使用 `getenv()`。 --- ### 🧪 示例代码： ```python import os # 获取已存在的环境变量 home_dir = os.getenv("HOME") print("HOME:", home_dir) # 例如: /Users/username 或 C:\Users\username # 获取不存在的环境变量 → 返回 None missing = os.getenv("NONEXISTENT_VAR") print("NONEXISTENT_VAR:", missing) # 输出: NONEXISTENT_VAR: None # 指定默认值 port = os.getenv("PORT", "8000") print("PORT:", port) # 若 PORT 未设置，输出 "8000" # 安全地转为整数（常用于配置端口等） port_int = int(os.getenv("PORT", "8000")) print("PORT (int):", port_int) ``` --- ### 🔍 补充说明： - 环境变量在不同系统中设置方式不同： - Linux/macOS：`export MY_VAR="hello"`（shell 中临时设置）或写入 `~/.bashrc`/`~/.zshrc` - Windows（CMD）：`set MY_VAR=hello` - Windows（PowerShell）：`$env:MY_VAR="hello"` - Python 启动后会**一次性加载**当前环境变量快照，后续系统中修改环境变量**不会自动同步**到已运行的 Python 进程。 - `os.getenv()` 返回值**始终是字符串类型**，需手动转换（如 `int()`, `bool()`）——注意处理 `None` 和空字符串。 ✅ 推荐实践：结合 `or` 或 `default` 避免 `None` 引发错误： ```python DEBUG = os.getenv("DEBUG", "False").lower() in ("true", "1", "yes") ``` --- ### ❗常见陷阱提醒： - ❌ 错误：`os.getenv("PORT") + 1` → 报 `TypeError: can only concatenate str (not "int") to str` - ✅ 正确：`int(os.getenv("PORT", "8000"))` - ❌ 错误：`os.getenv("DB_URL")` 返回 `None`，但代码直接 `.split("://")` → `AttributeError` - ✅ 正确：先检查 `if db_url := os.getenv("DB_URL"):`（Python 3.8+ 海象运算符）或用默认值兜底。 ---