spatie/laravel-view-models 仅支持 Laravel 9+，Laravel 8 及以下需手动构造 ViewModel；须手动注册 ServiceProvider、用 view() 传实例、在 toView() 中获取请求/认证数据。
composer require spatie/laravel-view-models 失败？先确认 Laravel 版本
这个包只支持 Laravel 9+，如果你用的是 Laravel 8 或更早版本，composer require spatie/laravel-view-models 会报依赖冲突——它硬依赖 laravel/framework:^9.0|^10.0|^11.0，不向下兼容。
常见错误现象：Root composer.json requires spatie/laravel-view-models ^3.0 -> found spatie/laravel-view-models[3.0.0, ..., 3.2.0] but these were not loaded，本质是版本锁死导致的解析失败。
- 运行
php artisan --version确认当前 Laravel 版本 - Laravel 8 及以下：别硬装，改用原生方式手动构造 ViewModel 类（无自动绑定）
- Laravel 9+：确保
composer.json中"minimum-stability": "stable"，避免 dev 分支干扰
view-models 不自动注入？检查服务提供者是否注册
安装后视图里写 {{ $viewModel->title }} 报 Undefined variable: viewModel，大概率是服务提供者没生效——这个包不会自动发现，必须手动加到 config/app.php 的 providers 数组里。
使用场景：你希望在 Blade 中直接用 $viewModel 而非 app(YourViewModel::class)，就得走自动绑定流程。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 打开
config/app.php - 在
'providers' => [...]数组末尾添加：Spatie\ViewModels\ViewModelServiceProvider::class - 执行
php artisan config:clear，别跳过这步，缓存不刷新就等于没注册
ViewModel 类里访问 Request 或 Auth 失败？别在构造函数里直接用 Facade
很多人把 Auth::user() 或 request()->query('search') 直接塞进 ViewModel 构造函数，结果测试时正常、线上报 Call to a member function query() on null——因为 Laravel 的服务容器在某些上下文（如队列、命令行）中可能还没完全启动请求栈。
参数差异：构造函数参数应只接收明确传入的对象（如 User $user），而非依赖全局状态。
- 正确做法：在
toView()方法里按需获取，它总在视图渲染前执行，上下文完整 - 示例：
public function toView(): array { return [ 'user' => Auth::user(), 'search' => request()->input('search', ''), ]; } - 性能影响：
toView()是懒加载时机，比构造函数里硬取更安全，也避免无谓的数据库查询
Blade 中怎么传参给 ViewModel？不是靠 @include，而是用 view() 函数
想给 ViewModel 传一个动态 ID，却写成 @include('posts.show', ['id' => $post->id])，结果 ViewModel 里收不到——@include 只传变量，不触发 ViewModel 绑定机制。
使用场景：你有一个 PostViewModel，需要根据路由参数或请求数据生成不同状态的视图数据。
- 正确调用方式：
return view('posts.show', new PostViewModel($post->id)); - 如果用控制器方法返回视图，确保
view()的第二个参数是 ViewModel 实例，不是数组 - 兼容性注意：Laravel 11 默认启用了「strict view binding」，传错类型（比如传数组）会直接报错，而不是静默忽略
view() 函数被显式传入实例时才激活绑定逻辑。漏掉这一步，或者版本/注册/传参任一环没对上，整个链路就断了——没有魔法，全是契约。 
