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 安装官方适配器：
-
Vue 项目：运行
composer require inertiajs/inertia-laravel - React 项目：同样安装该包（服务端适配器通用，与前端框架无关）
发布配置文件（可选但推荐）：php artisan vendor:publish --provider="Inertia\\ServiceProvider"，会生成 config/inertia.php，可自定义页面组件根路径、SSR 配置等。
2. 配置中间件与根布局
Inertia 要求所有 Inertia 请求都经过 Inertia\Inertia 中间件处理。Laravel 10+ 默认已注册 HandleInertiaRequests 中间件（位于 app/Http/Middleware/HandleInertiaRequests.php），确保它被应用到 web 路由组：
立即学习“前端免费学习笔记（深入）”；
- 检查
app/Providers/RouteServiceProvider.php中是否在withMiddleware方法里调用了$middleware->group('web', ...) - 确认
app/Http/Kernel.php的$middlewareGroups['web']包含App\Http\Middleware\HandleInertiaRequests::class
该中间件负责注入共享数据（如认证用户）、设置页面标题、处理 SSR 等。默认根模板是 resources/views/app.blade.php，需手动创建，内容只需一个空的 和加载前端资源的 script 标签（后续由 Vite/Webpack 注入）。
3. 前端初始化（Vue 或 React）
以 Vue 为例（使用 Vite）：
- 安装依赖：
npm install @inertiajs/vue3 vue@^3.4.0 - 在
resources/js/app.js中初始化：
import { createApp, h } from 'vue'
import { createInertiaApp } from '@inertiajs/vue3'
import { resolvePageComponent } from 'laravel-vite-plugin/inertia-helpers'
createInertiaApp({
title: (title) => ${title} - MyApp,
resolve: (name) => resolvePageComponent(./Pages/${name}.vue, import.meta.glob('./Pages/*/.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 通信。不复杂但容易忽略中间件或根模板配置。
