通八洲科技

React Router v6.4+ 路由嵌套与布局组件正确用法详解

日期:2025-12-31 00:00 / 作者:霞舞

当前问题源于在 navbar 中嵌套了独立的 `browserrouter`,导致其与主路由系统隔离;修复方式是移除冗余路由器,改用 `createbrowserrouter` + 布局组件 + `outlet` 实现统一导航与无刷新渲染。

在使用 react-router-dom v6.4+(推荐版本)时,必须确保所有 和路由匹配逻辑运行在同一个路由器上下文内。你原始代码中存在两个相互独立的路由器实例:

✅ 正确做法:使用布局路由(Layout Route)统一管理导航与内容区域

首先,彻底移除 NavBar 中的 BrowserRouter 及其内部的 Route/Routes(v6.4+ 已弃用 Route/Routes 在非 RouterProvider 下使用)。NavBar 应仅为纯展示组件,不承载路由能力:

// src/components/NavBar.tsx
import { Link } from "react-router-dom";

function NavBar() {
  return (
    
  );
}

export default NavBar;

接着,在 App.tsx 中定义一个布局组件(如 AppLayout),将 NavBar 与动态内容区()组合,并通过 children 配置嵌套路由:

// src/App.tsx
import {
  createBrowserRouter,
  RouterProvider,
  Outlet
} from "react-router-dom";
import NavBar from "./components/NavBar";
import HistoryPage from "./pages/HistoryPage";
import MainPage from "./pages/MainPage";

// 布局组件:复用导航栏 + 渲染子路由内容
const AppLayout = () => (
  <>
    
    
{/* 子路由元素将在此处渲染 */}
); // 主路由配置:根路径为布局组件,子路径对应具体页面 const router = createBrowserRouter([ { element: , children: [ { path: "/", element: }, { path: "/history", element: } // 可继续添加其他子路由,如 { path: "/about", element: } ] } ]); function App() { return ; } export default App;

⚠️ 关键注意事项

✅ 验证效果

完成上述修改后:

这正是 react-router-dom v6 推荐的现代路由架构:布局驱动、嵌套明确、状态隔离、体验流畅