用途：帮助在 Python 项目中实现依赖注入，解耦组件、提升可测试性，并使用 dependency-injector 库组织依赖。
主要能力：讲解控制反转（IoC）与三种注入风格（构造器、Setter、方法），推荐构造器注入；介绍 dependency-injector（v4.x，BSD，Python ≥ 3.8）的 Container 与 Provider 架构，涵盖 Singleton、Factory、Configuration、Resource、Callable、Object、Selector 等 Provider 类型；支持从环境变量、YAML、JSON、ini、dict、Pydantic 加载配置；通过 @inject 与 Provide[...] 配合 container.wire() 自动注入，可整包 wire；测试时用 container.override() 或 FastAPI 的 dependency_overrides 替换依赖；Resource 提供 init/shutdown 生命周期管理，并支持异步资源与 FastAPI Depends()。
使用方式：安装 pip install dependency-injector，可选 pip install "dependency-injector[yaml]" 或 pip install "dependency-injector[pydantic2]"。在 DeclarativeContainer 中声明 providers，加载配置后调用 container.wire(modules=[...]) 完成注入；资源型依赖需调用 init_resources() 与 shutdown_resources()。
适用场景：需要解耦、便于替换实现与测试的 Python 应用，以及 Flask、Django、FastAPI 等框架集成。
限制与注意：避免服务定位器、过度注入、紧耦合、作用域误用（如 Singleton 包装有状态请求对象）和测试中 monkey-patching；应面向抽象编程、集中配置依赖、避免循环依赖、锁定依赖版本。更详细的模式与框架集成见 references/patterns.md 与 references/framework-integration.md。