React / 系统课时
配置应用路由
配置应用路由
本课将为 React 应用建立可运行的页面路由,覆盖首页、商品列表、商品详情和管理页。完成后,地址栏路径、导航链接与页面组件会形成清晰映射,并支持详情页参数和未匹配地址处理。
学习目标
- 安装并接入
react-router-dom,让路由成为应用入口 - 使用嵌套路由组织公共布局与四类页面
- 通过动态参数读取详情页 ID,并验证导航结果
安装并规划路由
在现有 React 18 与 TypeScript 项目根目录执行:
bash
npm install react-router-dom预期结果
text
added <COUNT> packages<COUNT> 会随锁文件和本地缓存变化。命令成功退出后,可在 package.json 的 dependencies 中看到 react-router-dom。
路径与页面关系
本例使用一个根布局承载导航栏和 <Outlet />。首页使用 /,列表页使用 /products,详情页使用 /products/:productId,管理页使用 /admin,最后用 * 接收未知地址。

这套结构把公共框架放在父路由,把具体页面放在子路由。切换子页面时,导航栏保持不变,只有 <Outlet /> 所在区域更新。
编写完整路由入口
将下面内容写入 src/main.tsx。示例把页面组件放在同一文件中,便于直接运行;真实项目可再拆分到 pages 和 layouts 目录。
tsx
import { StrictMode } from "react";
import { createRoot } from "react-dom/client";
import {
Link,
NavLink,
Outlet,
RouterProvider,
createBrowserRouter,
useParams,
} from "react-router-dom";
const products = [
{ id: "101", name: "机械键盘" },
{ id: "102", name: "无线鼠标" },
];
function RootLayout() {
return (
<>
<header>
<nav>
<NavLink to="/">首页</NavLink>{" | "}
<NavLink to="/products">商品列表</NavLink>{" | "}
<NavLink to="/admin">管理页</NavLink>
</nav>
</header>
<main>
{/* 子路由组件会渲染到 Outlet 所在位置 */}
<Outlet />
</main>
</>
);
}
function HomePage() {
return <h1>首页</h1>;
}
function ProductListPage() {
return (
<>
<h1>商品列表</h1>
<ul>
{products.map((product) => (
<li key={product.id}>
<Link to={`/products/${product.id}`}>{product.name}</Link>
</li>
))}
</ul>
</>
);
}
function ProductDetailPage() {
const { productId } = useParams();
const product = products.find((item) => item.id === productId);
if (!product) {
return <p>商品不存在</p>;
}
return (
<>
<h1>商品详情</h1>
<p>
{product.name},编号:{product.id}
</p>
</>
);
}
function AdminPage() {
return <h1>管理页面</h1>;
}
function NotFoundPage() {
return <h1>页面不存在</h1>;
}
const router = createBrowserRouter([
{
path: "/",
element: <RootLayout />,
children: [
{ index: true, element: <HomePage /> },
{ path: "products", element: <ProductListPage /> },
{ path: "products/:productId", element: <ProductDetailPage /> },
{ path: "admin", element: <AdminPage /> },
{ path: "*", element: <NotFoundPage /> },
],
},
]);
const rootElement = document.getElementById("root");
if (!rootElement) {
throw new Error("找不到 #root 挂载节点");
}
createRoot(rootElement).render(
<StrictMode>
<RouterProvider router={router} />
</StrictMode>,
);预期结果
text
访问 / 显示“首页”
访问 /products 显示两条商品链接
点击“机械键盘”后进入 /products/101,并显示商品编号 101
访问 /admin 显示“管理页面”
访问 /unknown 显示“页面不存在”运行与验收
执行项目已有的开发命令:
bash
npm run dev预期输出
text
Local: http://localhost:<PORT>/<PORT> 由开发服务器决定,实际值可能不同。打开该地址后依次点击导航和商品链接,再直接修改地址栏路径,确认五种路由结果都符合预期。
部署到静态服务器时,浏览器直接访问 /products/101 会先请求服务器。服务器需要把未命中的前端路径回退到 index.html,否则刷新详情页可能返回 404;这属于部署配置,不是 React Router 本身的匹配错误。
按自己的节奏,确认真正理解。