Livewire 正确安装需先确认 Laravel 版本兼容性，再执行 composer require livewire/livewire；Laravel 8 需手动注册服务提供者，10+ 需显式添加 @livewireStyles 和 @livewireScripts 到 Blade 布局中。

Livewire 不是靠 npm 装的，也不是用 composer require laravel/framework 这类错误命令凑出来的——装错一步，Class 'Livewire\Livewire' not found 就立刻报给你看。

确认 Laravel 版本再动手

Livewire v3（当前最新）只支持 Laravel 10.42+ 和 11.x；Laravel 8 需手动注册服务提供者，低于 8 的版本直接不兼容。运行以下命令验证：

php artisan --version

常见错误现象：Class 'Livewire\Livewire' not found，大概率是你在 Laravel 7 或更老项目里硬装了 livewire/livewire。

• 用 composer create-project laravel/laravel myapp "11.*" 新建项目最稳妥
• 别用 composer require laravel/framework ——它只扔核心类进 vendor/，没 artisan、没路由、根本起不来
• 已有项目升级前，先查 官方兼容表，别赌小版本号

执行 composer require livewire/livewire

这是唯一正确的安装命令，没有其他变体。Laravel 9+ 会自动注册服务提供者；Laravel 8 则需手动加一行到 config/app.php 的 providers 数组里：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

Livewire\LivewireServiceProvider::class,

如果项目有 composer.lock，建议同步更新：

• composer update livewire/livewire —— 确保锁文件与实际安装一致
• 别用 composer install 单独装 Livewire：它只按 lock 文件还原，不会拉新包
• 若网络卡在 Loading composer repositories，换阿里云镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

@livewireStyles 和 @livewireScripts 必须显式写进 Blade

Laravel 10+ 默认不再自动注入 Livewire 脚本，哪怕你装对了、生成了组件，漏掉这两行，页面就只是静态 HTML。

把它们加进布局文件（如 resources/views/layouts/app.blade.php）：

• @livewireStyles 放在 前
• @livewireScripts 放在