深入理解 Vue3 Router:三种路由模式的工作原理与实战应用

引言

在 Vue 3 中,路由由 Vue Router 4 管理,支持三种模式:Hash 模式 、History 模式 和 Memory 模式 。

本文将详细介绍三种模式的实现原理、优缺点、使用场景,并对比它们的底层实现方法。


1. Hash 模式(createWebHashHistory)

创建方式

js 复制代码
import { createRouter, createWebHashHistory } from 'vue-router'

const router = createRouter({
  history: createWebHashHistory(),
  routes: [
    { path: '/', component: Home },
    { path: '/about', component: About }
  ]
})

URL 示例

复制代码
https://example.com/#/about

工作原理

  • 基于浏览器的 location.hash。
  • 通过监听 hashchange 事件来感知 URL 的变化。
  • # 后的部分不会被浏览器发送到服务器。

底层实现方法

  • location.hash = '#/about'
  • window.addEventListener('hashchange', callback)

优缺点

✅ 优点:

  • 不依赖后端配置,刷新不会 404。
  • 简单、快速。

❌ 缺点:

  • URL 不够美观(有 #)。
  • SEO 较差。

2. History 模式(createWebHistory)

创建方式

js 复制代码
import { createRouter, createWebHistory } from 'vue-router'

const router = createRouter({
  history: createWebHistory(),
  routes: [
    { path: '/', component: Home },
    { path: '/about', component: About }
  ]
})

URL 示例

复制代码
https://example.com/about

工作原理

  • 基于 HTML5 History API。
  • 通过 pushState / replaceState 修改浏览器历史记录。
  • 监听 popstate 事件来感知返回/前进操作。

底层实现方法

js 复制代码
history.pushState({}, '', '/about') // 修改地址栏
window.addEventListener('popstate', callback) // 监听前进/后退

优缺点

✅ 优点:

  • URL 美观。
  • SEO 友好。

❌ 缺点:

  • 必须有后端支持,否则刷新可能会报 404。

Nginx 配置示例

nginx 复制代码
location / {
  try_files $uri $uri/ /index.html;
}

3. Memory 模式(createMemoryHistory,旧称 Abstract 模式)

创建方式

js 复制代码
import { createRouter, createMemoryHistory } from 'vue-router'

const router = createRouter({
  history: createMemoryHistory(),
  routes: [
    { path: '/', component: Home },
    { path: '/about', component: About }
  ]
})

URL 示例

复制代码
(不会改变地址栏,仍然是当前页面 URL)

工作原理

  • 路由信息只存储在 内存 中。
  • 不依赖 window.location,不会修改浏览器地址栏。

底层实现方法

  • 内部用一个 JS 对象来维护当前路由状态(模拟栈结构)。
  • 类似:
js 复制代码
let historyStack = []
historyStack.push('/about')

使用场景

  • SSR(服务端渲染):保证每个请求有独立的路由状态。
  • 单元测试:不需要浏览器地址栏。

优缺点

✅ 优点:

  • 可运行在 Node.js、JSDOM 等环境。
  • 不依赖浏览器 API。

❌ 缺点:

  • 地址栏不会变化。
  • 不适合浏览器端作为主要模式。

📌 三种模式对比

模式 API URL 示例 刷新依赖后端 底层实现方式 使用场景
Hash createWebHashHistory() /#/about ❌ location.hash + hashchange 中小项目
History createWebHistory() /about ✅ pushState / replaceState + popstate 中大型项目
Memory createMemoryHistory() (URL 不变) ❌ 内存栈结构(JS 对象维护路由状态) SSR / 测试

总结

  • Hash 模式 :依赖 location.hash,最简单,适合快速上线的项目。
  • History 模式 :依赖 pushState / replaceState,URL 美观,需后端支持,适合大型应用。
  • Memory 模式:依赖内存存储,主要用于 SSR 和测试,不会改变浏览器地址栏。
相关推荐
Keith Guo1 小时前
ESP32-S31芯片架构中文件系统在不同的Flash的位置对PSRAM的性能影响
性能优化·架构·esp32
一条Go2 小时前
SSH 命令审核流:为什么「能执行」必须先「被批准」
后端·架构·github
超低空4 小时前
一文说清LRU算法
后端·算法·架构
AAA修煤气灶刘哥5 小时前
32 GB 内存跑起 1800 亿参数模型,代价是什么?
人工智能·后端·架构
AAA修煤气灶刘哥5 小时前
同一个项目,为什么换个 Agent 又得从头解释?
后端·架构·代码规范
谙弆悕博士6 小时前
多智能体架构详解:网状去中心化架构(Mesh对等P2P)
人工智能·架构·去中心化·p2p·多智能体·智能体·langgraph
微订校园外卖系统17 小时前
自己做校园外卖跑腿小程序用什么系统:多商户与单店架构
小程序·架构·外卖系统·本地生活·微订
雾隐隐o20 小时前
优搭校园 01|项目概览、技术选型与初始化
spring boot·mysql·vue
深入云栈20 小时前
Netty 4.2.x 源码深度解析 (二十四):池化内存分配 —— PoolArena、PoolChunk 与 PoolSubpage
java·后端·架构
Decay__1 天前
SQLServer 运维自动化平台 —— PowerShell + SQL Agent 作业:部署、监控、巡检、告警、工单闭环一体化
运维·数据库·sql·mysql·架构