PHP-DI容器需用ContainerBuilder构建并启用自动加载，禁用生产缓存；自动注入要求构造函数有类型提示且类可发现；注解需显式启用并用PHPDoc格式。
PHP-DI 容器初始化失败：require/autoload 没配对
直接 new Container() 会报错，PHP-DI 不提供无参构造函数。它依赖 ContainerBuilder 构建，且必须提前加载类自动加载器（否则 PhpFilesLoader 或注解解析器找不到类）。
- 确保已通过 Composer 安装：
composer require php-di/php-di - 入口文件开头必须有
require 'vendor/autoload.php';，漏掉这行，DI\ContainerBuilder类根本不会被识别 - 最简可用初始化写法：
use DI\ContainerBuilder; $container = (new ContainerBuilder())->build();
自动注入不生效：__construct 参数没类型提示或类未注册
PHP-DI 只能自动解析带明确类名类型提示的构造参数，且该类本身需可被容器发现（已定义、已扫描、或在默认自动解析范围内）。
- 错误写法：
public function __construct($logger)—— 没类型提示，容器无法知道你要什么 - 正确写法：
public function __construct(LoggerInterface $logger)，前提是LoggerInterface已绑定或可自动实例化 - 若类不在自动扫描路径（如自定义命名空间），需手动注册：
$container->set(MyService::class)->autowire(); - 别依赖“全类名字符串”传参，
$container->get('MyService')是兜底用法，不是自动注入逻辑
@Inject 注解失效：没启用注解支持且没加 use
PHP-DI 默认关闭注解解析，即使写了 @Inject 也完全忽略；同时注解需配合 use 声明才能被识别。
- 启用注解必须显式调用：
(new ContainerBuilder())->useAnnotations(true)->build(); - 在类中使用注解前，必须引入注解类：
use DI\Annotation\Inject; - 字段注入示例（仅限 public 属性）：
class UserService { /** * @Inject */ public UserRepository $repo; } - 注意：PHP 8+ 属性注解（
#[Inject]）PHP-DI 目前不支持，仍需 PHPDoc 风格
开发时改了类却没刷新容器：缓存没关或没清
PHP-DI 在生产环境默认启用编译缓存，但开发中改了构造函数或注解后，旧缓存会导致注入逻辑不更新，表现为“明明改了代码，依赖还是旧的”。
立即学习“PHP免费学习笔记（深入）”；
- 开发阶段务必禁用缓存：
(new ContainerBuilder())->disableCompilation()->build(); - 如果用了
setDefinitionCache()或配置了cacheDir，删掉对应目录或设为null - 常见误操作：只改了服务类，但忘了重启 CLI 进程（如 Swoole/Workerman 场景），容器单例不会自动重载
自动注入真正起效的前提，是类型、类路径、容器构建配置三者严丝合缝；少一个环节，就退化成手动 get() 调用——这点很容易被当成“框架问题”，其实是配置断点没找对。
