读取环境变量：Python 中 os.environ 的使用、getenv() 与 get() 的区别、处理缺失变量的默认值

环境变量这东西，说白了就是操作系统给程序递小纸条的一种方式。你不需要硬编码数据库密码、API Key 或者端口号，只要在启动时读一下环境变量就行。我刚开始写 Python 服务时，总觉得直接写在代码里挺方便，直到有一次把测试库的密码误提交到了 Git 仓库……嗯，从那以后我再也不敢偷懒了。

这一节我们重点聊三个事：怎么读环境变量、两种读取方式有什么差别、变量没设的时候怎么办。都是实战里每天要碰到的场景。

os.environ：环境变量的字典视图

Python 的 os.environ 是一个类字典对象，它把当前进程的所有环境变量都装了进去。你可以像操作普通字典一样操作它。

import os

# 读取单个变量
db_host = os.environ['DB_HOST']
print(db_host)  # 如果变量不存在，直接抛 KeyError

我个人习惯用 os.environ 做调试时的快速验证，因为它够直接。但生产环境里我几乎不用——你想想看，万一某个变量没设，程序直接崩溃，这谁受得了？

getenv() 与 get()：两个「安全读取」的兄弟

为了避免 KeyError，Python 提供了两个更温和的方法：os.getenv() 和 os.environ.get()。它们的作用几乎一样，但用法上有一点点区别。

说白了，os.getenv() 是 os.environ.get() 的语法糖。我做过测试，两者性能几乎没有差别，选哪个纯粹看个人喜好。

import os

# 使用 getenv()
port = os.getenv('APP_PORT', '8080')
print(f"服务端口：{port}")

# 使用 environ.get()
debug_mode = os.environ.get('DEBUG', 'false').lower() == 'true'
print(f"调试模式：{debug_mode}")

我在项目中遇到过一种情况：需要把环境变量转成布尔值或整数。这时候 os.environ.get() 配合链式调用会更顺手，因为你可以直接 .lower() 或 int()。

处理缺失变量的默认值

环境变量没设，是常态，不是异常。好的代码应该对缺失变量有「容错」能力。我总结了三种常见策略：

• 提供合理的默认值：比如端口默认 8080，日志级别默认 INFO。
• 显式报错并退出：对于数据库密码、密钥这类必须存在的变量，直接抛异常比悄悄用默认值更安全。
• 使用配置中心兜底：环境变量没设时，从配置文件或远程配置中心读取。

import os
import sys

# 策略一：提供默认值
db_host = os.getenv('DB_HOST', 'localhost')

# 策略二：必须存在的变量，缺失则退出
db_password = os.getenv('DB_PASSWORD')
if not db_password:
    print("错误：DB_PASSWORD 未设置，服务无法启动")
    sys.exit(1)

# 策略三：结合配置中心（伪代码）
config_source = os.getenv('CONFIG_SOURCE', 'local')
if config_source == 'consul':
    # 从 Consul 拉取配置
    pass

知识体系：环境变量读取流程

下面这张图把整个读取逻辑串起来了。你可以把它当作一个决策树来看：

实战建议：选哪个？怎么用？

我个人的经验是：

• 快速脚本、Demo、本地测试：用 os.getenv()，一行搞定，代码清爽。
• 生产服务、配置中心集成：用 os.environ.get()，方便链式调用和类型转换。
• 必须存在的变量：读取后立即判空，缺失则 sys.exit(1) 或抛自定义异常。