PHP-DI 的 enableCompilation() 在中文环境下不推荐启用，因其生成的缓存文件依赖 opcache，而中文路径、类名或注释中的 UTF-8 字符易引发 opcache 哈希冲突或解析异常，导致容器构建失败、服务解析错乱或 Entry not found 等问题。
PHP-DI 的 enableCompilation() 在中文环境下不推荐启用——它生成的缓存文件依赖 opcache，且中文路径、类名或注释中的 UTF-8 字符可能触发 opcache 文件哈希冲突或解析异常，导致容器构建失败或服务解析错乱。
为什么 PHP-DI 编译容器在中文项目里容易出问题
PHP-DI 的编译模式本质是把定义树序列化为 PHP 文件，再由 opcache 加载。但 opcache 对源码文件的哈希计算对 BOM、换行符、甚至某些 UTF-8 组合字符敏感。中文命名空间（如 App服务用户服务）或中文注释（如 /** @Inject */ 后跟中文说明）可能被部分 PHP 版本错误处理，造成：
• opcache_compile_file() 返回 false
• 编译后文件被跳过加载，容器退化为运行时解析
• 服务获取时抛出 Entry not found，但定义明明存在
替代方案：用 classmap + autowiring 稳定提速
真正有效的预编译不是靠 PHP-DI 自带的 enableCompilation()，而是借助 Composer 的自动加载优化：
• 运行 composer dump-autoload --classmap-authoritative --optimize
• 配合 PHP-DI 的 enableAutoWiring() 和 addDirectory()
• 容器启动时不再扫描文件，直接从 classmap 查类是否存在，再按类型提示注入依赖
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须确保所有服务类都在 PSR-4 映射路径下（如
"App\": "src/"），否则classmap-authoritative会漏掉 - 避免在
addDirectory()中传入含中文路径的字符串（如app/服务/），改用英文目录名 - 如果已有中文命名空间（如
App中文模块），需确认composer.json中 PSR-4 映射值是合法 UTF-8 字符串，且 Web 服务器文件系统编码一致
调试时别开编译，上线前删掉编译产物
开发阶段绝对不要调用 $builder->enableCompilation() —— 它生成的缓存文件（默认在 var/cache/di/）不会随代码变更自动刷新，中文类名修改后极易出现“旧定义残留”，表现为：
• 修改了 UserService 构造参数，get() 却仍用旧签名实例化
• dump($container->getContainer()->getDefinitions()) 显示的是编译前快照，不是当前代码状态
• 清除 opcache 后仍无效，必须手动删掉整个 var/cache/di/ 目录
- CI/CD 流水线中禁止执行
enableCompilation()，哪怕加了if (APP_ENV === 'prod')也不行 - 生产镜像构建时，只保留
composer install --no-dev --optimize-autoloader，不生成任何 PHP-DI 缓存文件 - 若真要预热容器，改用
php -r "require 'vendor/autoload.php'; (new DIContainerBuilder())->build();"触发 opcache 编译，比 PHP-DI 自己的编译更可控
最常被忽略的一点：PHP-DI 编译容器和 Composer classmap 是两套机制，混用反而增加故障面。中文项目里，老老实实走 classmap-authoritative + autowiring，既兼容又省心。
