React / 系统课时

配置基础路由

配置基础路由

本课将把一个只有单页面入口的 React 应用改造成多页面应用:安装路由库、定义地址与组件的映射,并验证浏览器访问不同路径时能渲染正确页面。

学习目标

  • 使用 BrowserRouter 为应用启用客户端路由
  • 使用 Routes 和 Route 定义基础路由表
  • 识别未匹配地址并显示兜底页面

安装路由依赖

React 本身负责组件渲染,不负责根据 URL 切换页面。项目需要安装 react-router-dom,再把路由能力接入应用入口。

bash
npm install react-router-dom

预期结果

text
added <COUNT> packages

<COUNT> 会随项目已有依赖和包管理器版本变化。安装后可在 package.json 的 dependencies 中看到 react-router-dom。

在应用入口启用路由

BrowserRouter 监听浏览器地址变化,并把当前路径提供给内部组件。它通常只在应用入口挂载一次。

jsx
// src/main.jsx
import { StrictMode } from "react";
import { createRoot } from "react-dom/client";
import { BrowserRouter } from "react-router-dom";
import App from "./App.jsx";

createRoot(document.getElementById("root")).render(
  <StrictMode>
    <BrowserRouter>
      <App />
    </BrowserRouter>
  </StrictMode>,
);

这段入口代码生效后,App 及其后代组件都可以使用 React Router 提供的组件和 Hook。

定义路由表

下面的示例把 /、/about 和 /products 分别映射到三个页面组件,并使用 * 捕获所有未匹配地址。

jsx
// src/App.jsx
import { Route, Routes } from "react-router-dom";

function HomePage() {
  return <h2>首页</h2>;
}

function AboutPage() {
  return <h2>关于我们</h2>;
}

function ProductsPage() {
  return <h2>商品列表</h2>;
}

function NotFoundPage() {
  return <h2>404:页面不存在</h2>;
}

export default function App() {
  return (
    <main>
      <h1>示例商城</h1>
      <Routes>
        <Route path="/" element={<HomePage />} />
        <Route path="/about" element={<AboutPage />} />
        <Route path="/products" element={<ProductsPage />} />
        <Route path="*" element={<NotFoundPage />} />
      </Routes>
    </main>
  );
}

预期结果

text
访问 /          显示:首页
访问 /about     显示:关于我们
访问 /products  显示:商品列表
访问 /unknown   显示:404:页面不存在

Routes 会在其直接子路由中选择与当前地址最匹配的一项,不会把所有 Route 同时渲染。element 接收的是 JSX 元素,因此要写成 <HomePage />,而不是只传组件名。

启动并验证

启动开发服务器后,分别在浏览器地址栏输入几个路径进行验证。

bash
npm run dev

预期结果

text
Local: http://localhost:<PORT>/

<PORT> 是开发服务器实际分配的端口。刷新 /about 等非首页地址时,如果生产服务器返回 404,需要把服务器配置为将未知前端路径回退到 index.html,再由 React Router 完成匹配。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置基础路由

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通