javaScript 实现 SPA路由 的核心是不刷新页面而动态替换内容并同步更新地址栏和导航行为,需监听 hashchange/popstate事件 、定义路由表、用history API 导航,并配置服务端 fallback;框架如react router、vue Router 提供嵌套路由、 懒加载 等高级功能;还需考虑状态保持与 seo 优化。

javascript 实现 路由 、构建单页面应用(SPA)的核心在于:不刷新页面,仅动态替换内容,并同步更新 浏览器 地址栏和前进 / 后退行为。关键不是重载整个 html,而是监听 URL 变化、匹配路径、加载对应视图或组件。
用原生 js 手写一个简易 前端 路由
适合理解原理或轻量项目,无需框架:
- 监听 hashchange 或 popstate 事件:hash 模式兼容性好(
#/home),history 模式更美观(/about),但需服务器配合 - 定义路由表:用 对象 映射路径到渲染函数,例如:
{'/': () => renderHome(), '/user': () => renderUser()} - 首次加载和跳转时,解析当前 URL 路径,执行对应函数;用
history.pushState()或location.hash触发跳转
用 History API 实现无刷新导航
现代 SPA 的基础,替代 hash:
-
history.pushState(state, title, url):添加新记录,不触发页面刷新,但需手动处理渲染 -
history.replaceState():替换当前记录(如表单提交后避免重复提交) - 必须监听
popstate事件来响应 浏览器 后退 / 前进,从中读取Event.state或重新解析location.pathname - 注意:服务端需配置 fallback——所有非 API 路径都返回
index.html,否则直接访问/dashboard会 404
用框架路由库快速落地(推荐生产环境)
React、Vue、Svelte 等都有成熟方案,封装 了嵌套路由、懒加载、守卫、参数解析等:
立即学习“Java 免费学习笔记(深入)”;
- React Router v6:用
<router></router>+<routes></routes>+<route></route>声明式配置,支持useNavigate编程式导航和useParams获取动态参数 - Vue Router:基于
createRouter({history: createWebHistory() }),路由文件集中管理,支持命名路由、路由元信息(如权限字段) - 关键点:路由组件通常按需加载(
import()动态导入),减少首屏体积
补充:状态与 SEO 的基本考量
SPA 天然面临两个问题,需主动应对:
- 状态保持:页面切换时,若用户填了一半表单,返回后应恢复。可用
sessionStorage缓存关键字段,或在路由离开前保存、进入时还原 - SEO 友好:纯客户端渲染对爬虫不友好。解决方案包括服务端渲染(SSR)如 Next.js/Nuxt,或生成静态页面(SSG)。简单项目可加
<meta name="fragment" content="!">配合预渲染服务