Laravel Livewire 不能单独安装使用，必须配合 Laravel 框架；执行 composer require livewire/livewire 仅引入依赖，需手动注册服务、发布资源，并在 Blade 中显式添加 @livewireStyles 和 @livewireScripts 才能生效。
Laravel Livewire 不能通过 Composer 单独“安装”成一个独立包来直接用，必须配合 Laravel 框架使用；你执行 composer require livewire/livewire 只是引入依赖，后续必须手动注册服务、发布资源、并在 Blade 中正确加载 JS/CSS 才能生效。
为什么 composer require livewire/livewire 后页面没反应？
常见错误现象：命令执行成功，app/Http/Livewire 目录也创建了，但组件渲染空白、控制台报 Livewire is not defined、表单提交无响应。
- 根本原因不是安装失败，而是 Livewire 的前端运行时（JS）没加载 —— 它不随 Composer 自动注入到页面
- Laravel 10+ 默认不再自动加载
app.blade.php中的 Livewire 脚本，必须显式添加@livewireStyles和@livewireScripts - 如果用了 Alpine.js 或其他 JS 框架，
@livewireScripts必须放在</body>闭合前，且不能被包裹在<script>标签里重复执行 - 开发环境未运行
php artisan serve或 Web 服务器未启用重写（如 Apache 缺少.htaccess），会导致 Livewire 的 HTTP 端点（/livewire/livewire.js）404
php artisan livewire:make 生成的组件为什么不渲染？
使用场景：你想快速建一个计数器组件，执行 php artisan livewire:make Counter，然后在 Blade 里写 @livewire('counter')，但页面只显示文字“counter”，没 HTML。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 确认组件类名和文件路径是否匹配：生成的类必须在
app/Http/Livewire/Counter.php，命名空间为App\Http\Livewire，且类名是Counter（首字母大写） -
@livewire('counter')中的字符串是 kebab-case，对应类名Counter；若类名是UserProfile，应写@livewire('user-profile')，大小写和连字符必须严格一致 - 组件的
render()方法返回的 Blade 视图路径要存在，比如return view('livewire.counter');就要求有resources/views/livewire/counter.blade.php - Blade 视图里不能漏掉
<div wire:ignore.self>之类破坏 Livewire DOM 树的指令，否则响应式更新会中断
升级 Laravel 后 Livewire 报 Call to undefined method Livewire\Livewire::component()
这是典型版本兼容问题：Livewire v3 要求 Laravel 10.28+ 或 Laravel 11，而 v2 最高只支持 Laravel 9.x。你执行 composer update 可能意外升到 v3，但框架版本没跟上。
立即学习“前端免费学习笔记（深入）”；
- 检查当前版本：
composer show livewire/livewire，若输出含3.x，而composer show laravel/framework是9.x，就必须降级 - 降级命令：
composer require livewire/livewire:^2.12（v2 最后稳定版），并删掉bootstrap/app.php中可能残留的->withMiddleware(...)里对 Livewire 的引用（v2 不走这个注册路径） - v2 和 v3 的组件写法差异大：v2 用
public $count = 0;+wire:model="count"，v3 改为#[Locked]属性或$this->count显式赋值，混用会静默失败 - 别信文档里“向后兼容”的说法——v3 的 JavaScript 包完全重写，v2 的
livewire.js路径（/livewire/livewire.js）在 v3 已废弃，改用 ESM 模块导入
最常被忽略的是：Livewire 的交互依赖于 Laravel 的 CSRF token 和 session 机制，如果你在非标准路由（比如 API 路由组）、或禁用了 session 的中间件下使用它，组件会完全失活，且控制台几乎不报错。
