React / 系统课时
认识单页应用路由
认识单页应用路由
单页应用路由解决的是“地址变了,但不要整页重新加载”的页面切换问题。本节会用浏览器 History API 和一个最小 React 示例拆开这条链路,让你看清 URL、路由状态与组件渲染之间的关系。
学习目标
- 说明单页应用路由与传统整页跳转的核心差异
- 理解
pushState、popstate与 React 渲染之间的配合 - 判断哪些地址变化属于客户端路由,哪些仍会触发服务器请求
路由到底切换了什么
传统多页网站点击链接后,浏览器通常会向服务器请求新的 HTML 文档;单页应用则尽量保留当前文档,只改变地址与应用状态,再由 React 重新渲染对应页面组件。
因此,“路由切页”并不是把一个 HTML 文件替换成另一个 HTML 文件,而是完成三件事:更新 URL、根据 URL 得到当前页面状态、让组件树渲染新的页面内容。

地址变化时浏览器发生什么
客户端主动切换页面时,可以调用 history.pushState() 写入新的历史记录。这个调用会改变地址栏,但不会自动向服务器请求新文档,也不会自动触发 popstate。
当用户点击浏览器后退或前进时,历史记录位置发生变化,浏览器才会触发 popstate。React 应用通常监听这个事件,把新的 location.pathname 写入状态,再按路径选择组件。
这里有一个关键边界:如果用户直接在地址栏输入 /about 并回车,或在该地址刷新页面,浏览器仍会向服务器请求 /about。生产环境需要把这类未知前端路径回退到应用入口 HTML。
用最小示例验证不刷新切页
下面代码可直接替换 Vite React 项目的 src/main.jsx。它没有使用第三方路由库,只用 History API 演示客户端路由最核心的工作方式。
import React, { useEffect, useState } from "react";
import { createRoot } from "react-dom/client";
function App() {
const [path, setPath] = useState(window.location.pathname);
useEffect(() => {
const handlePopState = () => setPath(window.location.pathname);
window.addEventListener("popstate", handlePopState);
return () => window.removeEventListener("popstate", handlePopState);
}, []);
function navigate(event, nextPath) {
event.preventDefault();
// pushState 只修改历史记录与 URL,不会重新加载当前文档。
window.history.pushState({}, "", nextPath);
setPath(nextPath);
}
return (
<main>
<nav>
<a href="/" onClick={(event) => navigate(event, "/")}>首页</a>
{" | "}
<a href="/about" onClick={(event) => navigate(event, "/about")}>关于</a>
</nav>
<h1>{path === "/about" ? "关于页面" : "首页"}</h1>
</main>
);
}
createRoot(document.getElementById("root")).render(<App />);预期结果
初始访问 / 时显示“首页”。
点击“关于”后,地址栏变为 /about,页面显示“关于页面”,当前文档不重新加载。
再点击浏览器后退按钮,地址恢复为 /,页面重新显示“首页”。容易混淆的边界
客户端路由并不会让服务器“认识”所有前端路径。应用内点击通常由 JavaScript 接管,而刷新、书签直达或外部链接访问仍从服务器开始,因此部署时需要配置 history fallback。
路由也不等于状态管理。路由状态描述“当前地址对应哪个页面”,表单内容、购物车或登录用户等业务状态仍应由组件状态、Context 或专门的状态管理方案负责。真正的路由库会在这个基础上继续处理路径匹配、嵌套、参数、重定向与数据加载等能力。