@inject 是 Blade 的语法糖，用于将容器实例绑定到模板变量，仅在当前模板作用域有效，不支持构造函数注入或传参，适用于轻量无副作用的服务调用如格式化、翻译等。
@inject 是 Blade 提供的语法糖，本质是将服务容器中的实例绑定到模板变量上。它不是“注入”到视图类本身，而是让 Blade 编译器在渲染前帮你从容器里 app() 出来并赋值给一个变量——所以它只在当前模板作用域有效，且不支持构造函数注入那种生命周期管理。
什么时候该用 @inject？
当你需要在 Blade 模板中直接调用服务方法，又不想把逻辑提前塞进控制器或 view composer 里时，比如：
- 在侧边栏显示用户未读通知数（用
NotificationService） - 根据当前请求生成带签名的 CDN 图片 URL（用自定义
CdnUrlGenerator） - 格式化金额（用
MoneyFormatter），且格式规则随 locale 变化
注意：如果该服务需要访问 request / session / auth 等运行时上下文，确保它本身是「每次解析都新建」或「request-scoped」绑定的，否则可能复用旧实例导致状态错乱。
@inject 的写法和常见错误
语法是 @inject('variableName', 'Fully\Qualified\Service\Class')，两个参数都必须是字符串字面量，不能拼接、不能变量插值。
常见错误包括：
A powerful memory management system powered by ReMe that provides persistent cross-session memory, automatic user preference application, and intelligent context compression for OpenClaw.
下载
由 ReMe 驱动的记忆管理系统，支持跨会话记忆持久化、自动应用用户偏好以及智能上下文压缩...
- 写成
@inject($userRepo, 'App\Repositories\UserRepository')—— 变量名不能带$，且必须是纯字符串 - 类名没加引号：
@inject(repo, App\Repositories\UserRepository)→ Blade 会当成函数调用报错 - 类未绑定到容器：若
App\Services\LoggerService没在AppServiceProvider::register()里$this->app->singleton()过，运行时报Target class [App\Services\LoggerService] does not exist
正确写法示例：
@inject('userRepository', 'App\Repositories\UserRepository')
@inject('formatter', 'App\Services\MoneyFormatter')
替代方案对比：为什么有时不该用 @inject？
它方便，但有明显局限：
- 无法传参：你不能写
@inject('cache', 'Illuminate\Contracts\Cache\Factory', ['ttl' => 3600])—— 第三个参数不被支持 - 调试困难：出错时堆栈指向 Blade 编译后文件，而不是原始模板行号
- 测试不友好：模板里硬依赖服务，单元测试时很难 mock
- 过度使用会让模板承担太多职责，比如用
@inject('paymentService')直接在模板里调用->createOrder()—— 这属于严重违反关注点分离
更推荐的做法是：把服务结果提前准备好，通过 with() 或 compact() 传入视图。只有当服务调用极其轻量、无副作用、且复用率高（如翻译、格式化）时，@inject 才值得考虑。
真正容易被忽略的一点：Blade 模板是缓存编译的，@inject 绑定的变量名一旦在模板中定义，就无法被子模板或 include 覆盖——哪怕你在 @include('partials.header') 里再写一遍 @inject('formatter', ...)，也只会用第一次声明的实例。
