laravel 集成 Inertia.js 的核心是服务端用 Inertia::render() 返回组件，前端用 @inertiajs/vue3 或 @inertiajs/react 接管导航；需安装适配器、配置 HandleInertiaRequests 中间件、创建 app.blade.php 根模板，并在控制器中返回 Inertia 响应。
在 Laravel 中集成 Inertia.js，核心是让服务端能响应 Inertia 请求并返回页面组件，同时前端通过 Inertia 的客户端接管常规跳转和表单提交。它不替换 Laravel 的路由和控制器逻辑，而是“包裹”原有流程——后端仍用 Blade 渲染逻辑（但实际不返回 html），前端用 Vue 或 React 渲染页面。
1. 安装 Inertia 服务端支持（Laravel）
使用 composer 安装官方适配器：
发布配置文件（可选但推荐）：php artisan vendor:publish --provider="InertiaServiceProvider"，会生成 config/inertia.php，可自定义页面组件根路径、SSR 配置等。
2. 配置中间件与根布局
Inertia 要求所有 Inertia 请求都经过 InertiaInertia 中间件处理。Laravel 10+ 默认已注册 HandleInertiaRequests 中间件（位于 app/http/Middleware/HandleInertiaRequests.php），确保它被应用到 web 路由组：
立即学习“前端免费学习笔记（深入）”；
- 检查
app/Providers/RouteServiceProvider.php中是否在withMiddleware方法里调用了$middleware->group('web', ...) - 确认
app/Http/Kernel.php的$middlewareGroups['web']包含AppHttpMiddlewareHandleInertiaRequests::class
该中间件负责注入共享数据（如认证用户）、设置页面标题、处理 SSR 等。默认根模板是 resources/views/app.blade.php，需手动创建，内容只需一个空的 <div id="app"></div> 和加载前端资源的 script 标签（后续由 vite/webpack 注入）。
3. 前端初始化（Vue 或 React）
以 Vue 为例（使用 Vite）：
（示例代码，非可执行）
import { createApp, h } from 'vue' import { createInertiaApp } from '@inertiajs/vue3' import { resolvePageComponent } from 'laravel-vite-plugin/inertia-helpers' <p>createInertiaApp({ title: (title) => <code>${title} - MyApp</code>, resolve: (name) => resolvePageComponent(<code>./Pages/${name}.vue</code>, import.meta.glob('./Pages/*<em>/</em>.vue')), setup({ el, App, props, plugin }) { const app = createApp({ render: () => h(App, props) }) app.use(plugin) app.mount(el) }, })React 类似，安装 @inertiajs/react，用 createInertiaApp + React.createElement 初始化，页面组件放在 Pages/ 目录下，扩展名用 .jsx 或 .tsx。
4. 控制器中返回 Inertia 响应
不再返回 view()，改用 Inertia::render()：
-
return Inertia::render('Dashboard')→ 对应resources/js/Pages/Dashboard.vue - 传参用第二个参数：
Inertia::render('User/Edit', ['user' => $user])，这些数据会作为 props 传给前端组件 - 支持重定向：
return redirect()->route('users.index')->with('success', 'Updated!')，Inertia 自动处理 XHR 重定向并保留 flash 消息
注意：所有 Inertia 页面必须通过控制器返回，不能直接访问 /dashboard 的 URL（除非服务端有对应路由和控制器方法）。
基本上就这些。关键点是服务端走 Inertia 响应流，前端用 Inertia 客户端接管导航，两者通过 json 通信。不复杂但容易忽略中间件或根模板配置。