配置与机密
真实的程序需要一些不应该写在代码里的设置:API 密钥、数据库 URL、调试开关。把它们放在代码外面有两个理由。第一,源代码里的机密会泄露:一旦你把 API 密钥提交到 git,它就永远留在历史记录里,推送到公开仓库就等于把它交给了全世界。第二,同一份代码应该能在不同地方(你的笔记本、服务器)用不同的设置运行。
标准答案是环境变量:操作系统交给你的进程的命名值。Python 从 os.environ 读取它们,用起来就像字典:
import os
key = os.environ["API_KEY"] # raises KeyError if missing
debug = os.environ.get("DEBUG", "off") # a safe default instead在开发时,你把它们放在一个永远不提交的 .env 文件里(你会把 .env 加进 .gitignore)。它只是一行行的 KEY=value:
API_KEY=sk-abc123
# a comment
MODEL=claude-opus-5-5
DEBUG=on像 python-dotenv 这样的库会替你把这个文件加载进 os.environ。在底层,它们解析的正是这些行。在这个练习里,你要自己写这个解析器,再加一个把机密打码的辅助函数,让它可以安全地打印到日志里。
黄金法则:从环境里读取机密,在日志里打码,永远不要硬编码。
写三个辅助函数。(1) load_env(text) 把 .env 文件的内容解析成字典。跳过空行和注释行(以 # 开头)。把剩下的每一行按第一个 = 拆开。去掉空白,如果值两端有一对引号也去掉。只有当键是有效的环境变量名时才保留这一行:全部大写,并且是有效的 Python 标识符(字母、数字和下划线,不以数字开头)。(2) get_setting(env, key, default=None) 如果存在就返回 env[key],否则返回 default。(3) redact(value) 返回一个可以安全记进日志的字符串,只显示最后 4 个字符,例如 redact("sk-abc123") 是 "****c123";4 个字符或更短的值变成 "****"。
这个练习即将开放
完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。
这个浏览器屏蔽了 learn.floati.life 的 Cookie,所以你在这里完成的课程无法按顺序打开。请允许这个网站使用 Cookie,然后重新加载。