结论先行:React Router v7 于 2024 年 11 月 22 日发布,最大的变化是把 Remix 的核心能力整体并入——框架模式下你获得 loader/action 数据模型、SSR/预渲染、文件路由与基于 Vite 的编译链,而不再需要单独安装 Remix。对已有 React SPA,v7 可以只当路由库用;对需要 SEO 与首屏速度的项目,框架模式是 React 生态里与 Next.js 并列的全栈选项。Remix 2 项目则有一条官方铺好的平滑迁移路径。
一、三种模式:按需取用
v7 把使用方式分成三档,复杂度递增:
声明模式:BrowserRouter + Routes,经典 SPA 路由,适合存量项目渐进升级;数据模式:createBrowserRouter 把路由配置移到渲染之外,支持 loader/action 与挂起状态,但没有服务端编译;框架模式:完整的 Remix 体验——文件即路由、SSR/SSG、自动代码分割、逐路由类型生成。
npx create-react-router@latest my-app关键认知:三种模式共享同一套 API 与心智模型,从声明模式迁到框架模式不需要换脑子,这是 v7 相对「另起炉灶学一个新框架」的最大优势。
二、loader:把数据请求挪到渲染之前
传统 React 的「渲染组件 → useEffect 里 fetch → setState」会制造请求瀑布:父组件取完数据子组件才开始取。loader 在路由匹配时就并行执行,组件渲染时数据已就绪:
// app/routes/user.tsx
import { useLoaderData } from 'react-router';
export async function loader({ params }) {
const [user, posts] = await Promise.all([
fetchUser(params.userId),
fetchPosts(params.userId),
]);
return { user, posts };
}
export default function UserPage() {
const { user, posts } = useLoaderData<typeof loader>();
return <h1>{user.name}</h1>;
}框架模式下 loader 默认跑在服务端,可以直接访问数据库与密钥;需要浏览器 API 时用 clientLoader,还能通过 serverLoader 参数与服务端数据组合。SSR 首屏因此天然带完整数据,搜索引擎与用户看到同一份 HTML。
三、action 与 useFetcher:变更即重验证
action 处理 POST/PUT/DELETE 等数据变更,完成后框架自动重新调用相关 loader——「提交 → 落库 → 界面刷新」是声明式的,不需要手动同步状态:
export async function action({ request }) {
const form = await request.formData();
const user = await createUser({ name: form.get('name') });
return redirect('/users/' + user.id);
}不想触发导航的交互(点赞、加购、实时搜索)用 useFetcher:它独立调用 loader/action,自带请求状态与竞态处理,过期请求自动取消。表单用 Form 组件提交,即使 JS 未加载也能走原生提交,渐进增强是内建的。
四、SSR、预渲染与类型安全
框架配置集中在 react-router.config.ts:
import type { Config } from '@react-router/dev/config';
export default {
ssr: true,
prerender: ['/', '/about'],
} satisfies Config;ssr 关掉就是纯客户端 SPA,prerender 列表在构建期生成静态 HTML,三种渲染形态一个配置切换。类型方面,react-router typegen 按路由生成类型,loader 返回值、路由参数、href 都有推断与检查;建议把 typegen 放在 tsc 之前执行,避免冷检出时的虚假报错。开发用 react-router dev(带路由模块热重载),构建用 react-router build,产物分 build/client 与 build/server 两部分。
五、从 Remix 2 迁移:包映射表
| 旧包 | 新包 |
|---|---|
| @remix-run/react | react-router(v7 统一导出) |
| @remix-run/node | @react-router/node |
| @remix-run/dev | @react-router/dev |
| @remix-run/serve | @react-router/serve |
| @vercel/remix | @vercel/react-router |
路由文件想保留 Remix v2 扁平命名,用 @react-router/fs-routes 的 flatRoutes() 一行搞定,URL 可以逐字节不变——这对 SEO 与外链至关重要。json() 助手移除,改返回原生对象或 Response.json;类型导入统一来自 react-router。社区已有文档站级项目的完整迁移案例,核心经验是:把「URL 全部 200、依赖树无 @remix-run 残留、SSR 首屏不回退」写成可执行验收清单,迁移就是一次机械替换。
六、loader 里的数据从哪来:可以不用自建后端
框架模式把「服务端取数」变成一等公民,但取数的后端不一定要自己写。做商城、会员、内容类应用时,可以直接在 loader 里调「api工厂」的开放接口:商品列表、订单、优惠券、CMS 文章都是现成能力,Web 端用 apifm-webapi SDK 封装,统一返回 {code,data,msg},code 为 0 即成功;loader 返回的数据自动注水到客户端,useLoaderData 直接消费,与上面的类型推断链路完全兼容。平台自带管理后台,运营改商品、发文章不需要开发者介入。
接口可先在 https://www.it120.cc/playground.html 在线调通再写进 loader;SDK 用法与六端支持见 https://www.it120.cc/sdk/index.html 。对独立开发者,这等于把 React Router 的全栈能力与现成业务后端拼成完整闭环。
文章标签
相关产品
api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。