不过，

刚开始学 React Router 时我把它理解成“点击链接。换一个组件”，这个说法不能算错，但它解释不了几个很快就会遇到的问题：

• 为什么地址栏变了页面却没有整页刷新？怎么说呢，
• /user/:id 的 :id 怎么交给组件？
• 为什么父路由里还需要一个 ？
• 未登录访问支付页，登录后怎样回到原来的页面？
• 本地开发一切正常，部署后刷新 /products/ 为什么变成服务器错误？

一、前端路由到底解决了什么？

传统多页应用点击链接时浏览器通常会向服务器请求另一份 HTML 文档。旧页面卸载、新页面重新加载，中间可能出现明显的白屏。JavaScript 状态也会随页面重载丢失。

SPA通常只在首次访问时加载主 HTML。之后的应用内导航大致经历三步：

1. 修改浏览器当前 URL；
2. 路由器根据 URL 匹配路由规则；按理说，
3. React 渲染匹配到的组件树。怎么说呢，

这三步不需要为每一次内部导航重新请求整份 HTML。所以页面切换更连贯，应用状态也更容易保留。

二、这个项目用的是 BrowserRouter，不是 HashRouter

注意！如果你误用了 HashRouter。而代码中却导入了 BrowserRouter，就会导致部署后刷新失效。老实说，

代码中实际使用的是：

import { BrowserRouter as Router } from 'react-router-dom';

BrowserRouter 用 History API 管理导航。其典型 URL 为：

https://example.com/products/

HashRouter 会把方法放在 # 后面例如 https://example.com/#/products/，这两种写法在服务器设置和客户端行为上完全不同。老实说，

三、先搭起最小路由骨架

import { BrowserRouter。Link,Navigate,Route,Routes } from 'react-router-dom';其实，function App {
return (



} />
} />
} />
} />


);}

• BrowserRouter:   监听地址变化，为后代组件提供上下文。
• Routes:   挑选最佳匹配方法。
• Route:   声明方法与元素映射。
• Link:   声明式内链导航，不触发全局刷新。
• Navigate:   渲染阶段执行重定向，并可通过 replace 替换历史条目。

四、路由懒加载：先下载当前真正需要的页面

"所有代码都一次性打包进入口文件，会让首屏加载缓慢。"——这正是懒加载能解决的问题。如果所有页面都静态导入，在首页首次打开时就要下载和解析所有模块。即使使用者根本不会进入其中大部分页面。使用 React.lazy + Suspense 可以实现按需分割。话说回来，避免过度拆分，否则会导致多次请求和短暂等待。" "动态 import 告诉建立工具这里可以拆分代码；lazy 把异步模块包装成 React 组件；话说回来，Suspense 在模块尚未加载时显示 fallback。"——这些环节必须同时理解才能正确使用懒加载。"

import { lazy,Suspense } from 'react';const Home = lazy => import);const About = lazy => import);const ProductDetail = lazy => import);说起来，function App {
return (

`Loading...`}`}>







);}

五、动态路由：把 URL 的一段交给组件

Pseudo‑URL 参数通过冒号定义：

&{}
// UserProfile.jsx
import { useParams } from 'react-router-dom';function UserProfile {
const { id } = useParams;// 从 URL 拿到字符串
return (
&{

User Profile: ${id}
}
);}
<\/script>`;

1️⃣ : 对参数做校验并处理空数据或请求失败。老实说，⚠️ 参数来自客户端，可被恶意篡改，请勿直接用于安全敏感操作。

六、嵌套路由：父页面提供布局，Outlet 决定子页面位置

tsx // 父级产品列表 }> {/* 子级 – 新建 /} } /> {/ 子级 – 查看详情 */} } />

// Products.jsx import { Outlet } from 'react-router-dom';export default function Products { return ( • • );}

• “new”不会被 “:
• 父级可保持侧栏或顶部导航不变，只替换 Outlet 内部内容。

七、权限守卫：记住使用者从哪里来

tsx import { Navigate,useLocation} from 'react-router-dom';function readDemoLogin{ try{return localStorage.getItem==='true';}catch{return false;按理说，} } function Protected { const location = useLocation;if ){ return ();} return children;} **关键点** * `state.from` 同时保存 pathname/search/hash，让登录成功后可以精准返回。* `replace` 防止后退时 落回拦截页。**登录流程** tsx const location = useLocation;const navigate = useNavigate;const from = location.state?.from，?'/'，function saveDemoLogin{try{ localStorage.setItem;return true，} catch{return false;} } function handleLoginSuccess{ if){ alert;return，} navigate;说起来，} **提醒** * 前端 guard 单纯是体验调整；老实说，真正鉴权必须在服务器完成。---

八、兜底与编程式导航

tsx // 通配符通用 NotFound 页面 import {useEffect,useNavigate} from 'react-router-dom';话说回来，export default function NotFound{ const navigate = useNavigate;useEffect=>{ const timer=setTimeout=>navigate,3000);return=>clearTimeout;},)，return (

Not Found 页面…等待跳转，⏱️⌛️  ⌛️⌛️ ⏱️ ⏱️ ⏱️  ⏰        🕐🕑🕑⏰⏰🕐💯💯💯💯💯💯 💬 💬 💬 💬💬💬 💬✨✧✧✨✧✧ ✨ ✧ ✧ ✨✨ ✨✨✦☆☆☆ ☆☆★★ ★★★★ ★★★★★★ ★★★★★★★ ★★★★★★★★★★ ★★★★★★★★★★★★★★ 🗣️🗣️🤘🤘🙈🙈🙈🙈🙏🙏📢📢🤝🤝🥂🥂🏆🏆🍾🍾👑👑🚀🚀🚀 🚀🚀🔚🔚🔚 🔚🔚🔚 🔔🔔🔔 🔔🔔🔔 🔓🔓🔓 🔓🔓🔓 ⚠⚠⚠ ⚠⚠⚠ ⚡⚡⚡ ⚡⚡⚡ ⚙⚙⚙ ⚙⚙⚙ 🛠🛠🛠 🗜🗜🗜 🗜🐍🐍🐍 🐍🐍🐍 🐎🐎🐎 🌟🌟🌟 ⭐⭐⭐⭐⭐ ☁☁☁ ☃☃☃ 🌪🌪🌪 🌫🌫🌫 🌉🌉🌉 🚅🚅🚅 🚄🚄🚄 🚆🚆🚆 🚇🚇🚇 🚈🚈🚈 🚊🚊🚊 ☺☺☺☺☺☺☺☺☺ ☺😋😋😋😋😋 😇😇😇 😸😸😘😘 😸 😺 😻 😼 😽 😾 😉 🙃 🤨 🤪 🤭 🤤 👹 👻 👽 👾 🤖 👿 👍 👍 👍 👍 👍 👍👍👍👍👍👍👍👌👌👌👌👌👌";)，};` **区别** | 场景 | 推荐 API | |------|----------| | 条件渲染时进行重定向 | `` | | 表单提交/按钮点击/定时器等事件中跳转 | `useNavigate` | ---

九、“为什么部署后刷新深层路由会报错？”

当你直接访问 `` 或在该地址按 F5 时： * 浏览器向服务器发送 `` 请求；* 若服务器只知道静态文件目录，则返回 **404** 或其它错误；按理说，* React 应用根本无法启动。为了解决此问题，需要让 **服务器把找不到文件的请求回退到 `index.html`**。例如 Nginx 常见配置： nginx location / { try_files $uri $uri/ /index.html;} 如果你的应用托管在子目录。还需同步 Vite 的 `` 与 `basename` 配置，否则资源方法与路由方法不一致。话说回来，---

十、“我的 React Router 检查清单”

clearAllSelection

' '

' '

A ' '