核心概覽

在 Vue.js 單頁應用（SPA）中，vue-router 提供了三種不同的 歷史模式 來管理路由導航和 URL 顯示方式。每種模式適用于不同場景，理解其原理與配置是構(gòu)建現(xiàn)代前端應用的關(guān)鍵。

一、Hash 模式（哈希模式）

基本概念

• 利用 URL 中的 # 后面的部分（即 hash）來模擬頁面跳轉(zhuǎn)。
• 瀏覽器不會將 # 后的內(nèi)容發(fā)送到服務器，因此無需后端支持。

示例代碼

import { createRouter, createWebHashHistory } from 'vue-router'

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

訪問地址如：https://example.com/#/home

優(yōu)點

• 兼容老版本瀏覽器（IE9+）
• 無需服務器額外配置
• 開發(fā)調(diào)試方便

缺點

• URL 不美觀，帶有 #
• 對 SEO 不友好（搜索引擎可能忽略 hash 內(nèi)容）

二、HTML5 模式（瀏覽器歷史記錄模式）

 基本概念

使用 HTML5 的 history.pushState() API 實現(xiàn)真實的 URL 路徑。

URL 更加“正常”，例如：https://example.com/user/123

示例代碼

import { createRouter, createWebHistory } from 'vue-router'

const router = createRouter({
  history: createWebHistory(),
  routes: [
    { path: '/user/:id', component: UserComponent }
  ]
})

關(guān)鍵問題：404 錯誤

當用戶直接訪問 /user/123 時，請求會發(fā)送給服務器。如果服務器沒有對應資源，則返回 404。

解決方案：Fallback 回退機制

所有非靜態(tài)資源請求都應返回 index.html，交由前端路由處理。

常見服務器配置示例：

服務器：nginx

配置方法

location / {
  try_files $uri $uri/ /index.html;
}

Apache 

| Express (Node.js) | 使用中間件：

const history = require('connect-history-api-fallback');
app.use(history());

| Firebase Hosting | 在 firebase.json 添加：

{
  "hosting": {
    "rewrites": [
      { "source": "**", "destination": "/index.html" }
    ]
  }
}

| Netlify | 創(chuàng)建 _redirects 文件：

/* /index.html 200

| Vercel | 創(chuàng)建 vercel.json：

{ "rewrites": [{ "source": "/:path*", "destination": "/index.html" }] }

優(yōu)點

• URL 美觀，符合現(xiàn)代 Web 標準
• 利于 SEO 優(yōu)化
• 用戶體驗更自然

缺點

• 必須配合服務器正確配置
• 配置不當會導致 404

三、Memory 模式（內(nèi)存模式）

基本概念

將路由狀態(tài)保存在內(nèi)存中，不依賴瀏覽器的 URL 或歷史棧。

完全由 JavaScript 控制導航。

示例代碼

import { createRouter, createMemoryHistory } from 'vue-router'

const router = createRouter({
  history: createMemoryHistory(),
  routes: [
    { path: '/login', component: LoginComponent }
  ]
})

// 手動觸發(fā)初始導航（必須?。?
router.push('/login')

適用場景

• 服務端渲染（SSR）
• Node.js 后端環(huán)境
• 單元測試或自動化腳本
• 移動端 WebView 或 Electron 應用（可選）

注意事項

• 瀏覽器中無法使用前進/后退按鈕
• 頁面刷新后路由狀態(tài)丟失
• URL 不更新，不利于分享

補充知識點：處理 404 頁面

由于 HTML5 模式下所有路徑都被重定向到 index.html，服務器不再返回 404，因此需要在前端實現(xiàn)通用匹配路由。

前端萬能路由配置

const routes = [
  { path: '/', component: Home },
  { path: '/about', component: About },
  // 通配符路由必須放在最后
  { path: '/:pathMatch(.*)*', name: 'NotFound', component: NotFoundComponent }
]

也可以解構(gòu)參數(shù)：

// 訪問 /not-found 時
this.$route.params.pathMatch // "not-found"

更佳實踐（SSR 場景）

在服務端預先用路由器匹配 URL：

• 匹配成功 → 渲染頁面
• 匹配失敗 → 返回 HTTP 404 狀態(tài)碼

查看 Vue SSR 文檔 獲取更多細節(jié)。

對比圖表：三種歷史模式一覽表

知識點詳解

下列為解決上述內(nèi)容所涉及的核心知識點：

1.HTML5 History API

通過 $window.history.pushState() 動態(tài)修改 URL 而不刷新頁面，是實現(xiàn) HTML5 模式的基礎。它允許 SPA 擁有“真實”路徑。

2.URL 重寫與回退機制

服務器需配置將所有未命中靜態(tài)資源的請求指向 index.html，從而交由前端路由處理，避免 404 錯誤。

3.通配符路由匹配

使用 /:pathMatch(.*)* 捕獲任意未知路徑，在前端展示 404 頁面，彌補服務器回退帶來的錯誤掩蓋問題。

總結(jié)建議

附加提示

若部署在子目錄（如 /my-app/），記得設置 base: '/my-app/'：

const router = createRouter({
  history: createWebHistory('/my-app/'),
  routes: [...]
})

構(gòu)建工具（Vue CLI / Vite / Nuxt）通常已集成相關(guān)插件，但仍需手動配置服務器規(guī)則。

使用 CI/CD 部署時，確保 _redirects 或 vercel.json 等文件包含在構(gòu)建輸出中。

到此這篇關(guān)于Vue Router的三種歷史模式應用與對比詳解的文章就介紹到這了,更多相關(guān)Vue Router歷史模式內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論