推荐用 os.environ.get() 读取环境变量并显式设默认值，避免 keyerror；敏感变量优先结合 python-dotenv 加载 .env 文件；所有值均为字符串，需手动类型转换；测试时用 patch.dict 或 monkeypatch 安全模拟。
os.environ.get() 是唯一推荐的读取方式
直接访问 os.environ['KEY'] 会在键不存在时抛出 KeyError，生产环境里这等于主动制造崩溃点。必须用 .get() 方法，并显式提供默认值——哪怕只是 None。
常见错误现象：本地开发时变量都配好了，一上 CI/CD 或容器就报 KeyError: 'DATABASE_URL'，其实只是环境没传进去。
- 永远写成
os.environ.get('DB_HOST', 'localhost')，别省略第二个参数 - 如果业务逻辑依赖该变量非空，就在获取后加校验，而不是指望
os.environ自动兜底 - 避免链式调用如
os.environ.get('PORT').strip()，万一返回None就触发AttributeError
敏感变量别裸奔，优先走 dotenv + os.environ.get()
开发阶段把密钥写进 .env 文件再加载，比硬编码或裸读系统环境更可控。但注意：python-dotenv 默认只加载当前目录下的 .env，不会递归向上找，也**不自动覆盖已存在的同名环境变量**（这是安全设计，不是 bug）。
使用场景：本地调试、CI 中注入测试配置、Docker 容器启动前预加载。
python-docx Skill功能概述python-docx Skill是一项面向实际任务的技能，主要用于本Skill提供使用python-docx生成专业Word文档的标准方法和最佳实践；生成安全服务方案文档；核心要点生成技术架构设计文档；生成任何需要专业排版的Word文档；核心库 : python-docx；使用与执行辅助库 : docx.shared , docx.enum , docx.oxml.ns；标准代码模板；1. 文档初始化；2. 字体设置（必须！它将相关步骤、工具调用和结果整理方式集
- 先装包：
pip install python-dotenv - 在入口文件顶部加：
from dotenv import load_dotenv; load_dotenv() - 后续仍统一用
os.environ.get('API_KEY')读取，和线上行为一致 - CI 脚本里别 mix
export API_KEY=xxx和load_dotenv()，后者不会覆盖前者，容易误判生效顺序
类型转换要自己动手，os.environ 只返回字符串
os.environ 所有值都是字符串，哪怕你设的是 DEBUG=true 或 PORT=8000，Python 不会自动转布尔或整型。靠直觉判断 if os.environ.get('DEBUG'): 会踩坑——空字符串、'false'、'0' 全是真值。
性能影响：类型转换开销可忽略，但逻辑错位代价极高。
- 布尔值用
os.environ.get('DEBUG', '').lower() in ('1', 'true', 'yes', 'on') - 整数用
int(os.environ.get('PORT', '8000'))，但记得包try/except ValueError - 列表类变量（如逗号分隔的 host 列表）得手动
.split(',')并strip()每一项
测试时别 mock os.environ 全局字典，改用 patch.dict
直接改 os.environ['TEST_VAR'] = 'mock' 会影响其他测试用例，且 tearDown 清理不干净。Python 标准库的 unittest.mock.patch.dict 是专为此设计的安全方案。
容易被忽略的地方：很多教程教用 @patch('os.environ', ...)，但这是替换整个模块属性，会断掉真实环境变量继承（比如 PYTHONPATH），导致测试失真。
- 正确写法：
@patch.dict(os.environ, {'DB_URL': 'sqlite:///test.db'}) - 函数内临时修改：
with patch.dict(os.environ, {'DEBUG': '1'}): do_something() - pytest 用户可用
monkeypatch.setenv('KEY', 'val')，效果等价且更轻量
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
