资深Python开发者遵循的7个最佳实践（初学者常常忽略）
内容提要
资深Python开发的核心是减少意外。文章提出七项实践：依赖注入便于测试替换；用上下文管理器管理资源清理；为外部调用设超时；日志记录可调查的上下文；测试失败路径而非仅正常路径；在pyproject.toml声明元数据；删除前先弃用。这些习惯把隐藏假设变得可审查，让代码经得起维护。
延伸解读
从“能跑”到“可维护”：隐藏假设的代价
文章开篇指出，许多代码能通过审查和测试，却隐藏着生产环境中的风险。例如，函数内部自建HTTP客户端、无限等待网络、日志缺少关键上下文，这些都不是风格问题，而是假设问题。资深开发者通过七项实践，将这些隐藏假设暴露出来，使其可审查、可测试。这提醒我们，代码质量不仅在于命名和格式，更在于对失败路径和外部依赖的显式处理。
依赖注入与协议：提升可测试性与可替换性
文章强调，将依赖作为参数传入，并用Protocol定义接口，可以使测试替换协作对象变得简单。Protocol提供结构化类型，无需继承，但需注意它仅是类型检查工具，非运行时验证。这一实践让代码的依赖关系显式化，测试时可用轻量假对象替代真实网络调用，从而快速验证逻辑。当协作对象增多时，注册表模式可保持连接清晰。
超时与日志：为外部调用加上安全网
每个外部等待都应有超时，否则就是未声明的失败模式。Python 3.11+的asyncio.timeout()可限制异步操作，同步客户端则需各自配置。超时后需决定重试、降级或报错。同时，日志应包含可调查的上下文，如job_id和记录数，而非笼统的“处理失败”。标准库的extra参数和LoggerAdapter能附加字段，但切记不要记录敏感信息。
测试失败路径与元数据声明：契约的保障
测试不应只覆盖正常路径，而应验证失败契约，如空输入、超时、异常响应。参数化测试和monkeypatch能高效模拟这些场景，断言应关注调用者可观察的行为，而非内部实现细节。此外，在pyproject.toml中声明构建系统、依赖和Python版本要求，能让协作者和CI直接了解运行假设。弃用公共行为时，使用warnings并配置测试将弃用警告转为错误，确保迁移路径清晰。
Q&A
资深Python开发者遵循的7个最佳实践是什么？
1. 依赖注入：将依赖作为参数传入，便于测试替换；2. 使用上下文管理器管理资源清理；3. 为每个外部调用设置超时；4. 记录带有可调查上下文的日志；5. 测试失败路径而不仅仅是正常路径；6. 在pyproject.toml中声明包元数据；7. 删除公共行为前先弃用。
为什么Python中要使用依赖注入而不是在函数内部创建依赖？
依赖注入让调用者能看到需要哪些协作者，使代码更易于测试和替换。如果在函数内部创建依赖（如httpx.Client()），测试要么访问真实网络，要么需要深入模块内部打补丁。通过接受依赖（如使用Protocol类型），可以用简单的假对象替代网络，无需框架。
如何为Python中的外部调用设置超时？
对于异步操作，Python 3.11+可以使用asyncio.timeout()来限制等待时间，并在块外捕获TimeoutError。对于同步客户端，需要为每个HTTP、数据库或队列库配置其支持的特定超时机制。关键是为每个外部等待设置截止时间并决定超时后的响应（重试、回退或报错）。
在Python中如何记录有助于调查问题的日志？
使用标准库的logging模块，通过extra参数添加结构化字段，如log.info("import finished", extra={"job_id": "j-193", "records": 4211})。配置格式化器包含这些字段，输出如import finished job=j-193 records=4211。对于相关调用，可以使用LoggerAdapter附加共享上下文。注意不要记录敏感信息如令牌或密码。
为什么测试失败路径比只测试正常路径更重要？
只测试正常路径无法验证边界行为，失败路径测试能确保代码在异常情况下正确响应。使用pytest.mark.parametrize覆盖丑陋输入，用monkeypatch模拟外部故障。断言应关注调用者可观察的行为（如异常、日志字段、清理动作），而不是内部调用序列，以避免测试脆弱。
pyproject.toml在Python项目中有什么作用？
pyproject.toml声明项目的构建方式、依赖和Python版本要求，使机器可读。它包含[build-system]（构建方式）、[project]（元数据如requires-python和dependencies）和[tool]（工具配置）。这有助于新贡献者和CI了解运行时假设，但注意声明依赖版本是假设，不是锁定，锁定需要单独工具。
在Python中弃用公共函数时应该注意什么？
使用warnings.warn发出DeprecationWarning，设置stacklevel=2以指向调用者行，消息中指明替代函数。注意Python默认在__main__外隐藏DeprecationWarning，因此需在发布说明和测试配置中显式显示。可以在pytest配置中设置filterwarnings = ["error::DeprecationWarning"]将弃用警告转为错误。流程：发布替代、警告旧路径、文档迁移、监控使用，最后在计划发布中移除。
