深入分析 Vue Router 的历史模式 (History Mode) 实现原理，包括 History API 和路由守卫的协同工作。

admin
Mon, 28 Jul 2025 18:23:25 +0000
Vue, history, router, vue

Vue Router History Mode：一场前端地址栏的“变形记” 大家好！欢迎来到今天的“前端冷知识”讲座。今天我们要聊聊Vue Router的History Mode，这玩意儿就像一个魔术师，能让你的单页面应用在浏览器地址栏里看起来像一个真正的多页面应用。 别被“History”这个词吓到，它其实没你想的那么高深莫测。简单来说，History Mode就是利用浏览器的History API，在不刷新页面的情况下，改变地址栏的URL，从而实现前端路由的切换。 1. 告别“#”：History Mode的诞生 在History Mode出现之前，Vue Router默认使用Hash Mode。Hash Mode的URL里会带一个“#”号，例如：http://example.com/#/home。这个“#”后面的内容不会发送到服务器，所以前端可以自由地控制它的变化，从而实现路由切换。 但问题来了，“#”号总是显得有点碍眼，而且对于SEO也不太友好。于是，History Mode应运而生，它的URL看起来就像这样：http://example.com/home，是不是感觉清爽多了？ …

继续阅读“深入分析 Vue Router 的历史模式 (History Mode) 实现原理，包括 History API 和路由守卫的协同工作。”

The post 深入分析 Vue Router 的历史模式 (History Mode) 实现原理，包括 History API 和路由守卫的协同工作。 first appeared on 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座.

Vue Router History Mode：一场前端地址栏的“变形记”

大家好！欢迎来到今天的“前端冷知识”讲座。今天我们要聊聊Vue Router的History Mode，这玩意儿就像一个魔术师，能让你的单页面应用在浏览器地址栏里看起来像一个真正的多页面应用。

别被“History”这个词吓到，它其实没你想的那么高深莫测。简单来说，History Mode就是利用浏览器的History API，在不刷新页面的情况下，改变地址栏的URL，从而实现前端路由的切换。

1. 告别“#”：History Mode的诞生

在History Mode出现之前，Vue Router默认使用Hash Mode。Hash Mode的URL里会带一个“#”号，例如：http://example.com/#/home。这个“#”后面的内容不会发送到服务器，所以前端可以自由地控制它的变化，从而实现路由切换。

但问题来了，“#”号总是显得有点碍眼，而且对于SEO也不太友好。于是，History Mode应运而生，它的URL看起来就像这样：http://example.com/home，是不是感觉清爽多了？

2. History API：幕后英雄

History Mode之所以能够实现，离不开浏览器的History API。这个API提供了一些方法，让我们可以在不刷新页面的情况下，修改浏览器的历史记录。

History API主要包括以下几个方法：

方法 | 作用
history.pushState(state, title, url) | 向历史记录中添加一个新的状态。state是一个与历史记录项关联的JavaScript对象，title是页面的标题（大多数浏览器会忽略这个参数），url是新的URL。注意，pushState不会触发页面刷新，只会改变地址栏的URL。
history.replaceState(state, title, url) | 替换当前的历史记录项。参数与pushState相同。replaceState也不会触发页面刷新，只会改变地址栏的URL。
history.go(delta) | 在历史记录中向前或向后移动。delta是一个整数，表示要移动的步数。例如，history.go(1)表示前进一页，history.go(-1)表示后退一页。
history.back() | 等同于 history.go(-1)，后退一页。
history.forward() | 等同于 history.go(1)，前进一页。

Vue Router的History Mode就是利用pushState和replaceState方法来改变地址栏的URL，从而实现路由切换。

3. Vue Router的History Mode配置

要在Vue Router中使用History Mode，只需要在创建Router实例时，将mode选项设置为'history'即可：

import Vue from 'vue'
import VueRouter from 'vue-router'

Vue.use(VueRouter)

const routes = [
  { path: '/', component: Home },
  { path: '/about', component: About }
]

const router = new VueRouter({
  mode: 'history',
  routes
})

new Vue({
  router,
  render: h => h(App)
}).$mount('#app')

这样，你的Vue应用就会使用History Mode了。

4. 路由守卫：保驾护航

虽然History Mode让URL看起来更美观，但它也带来了一个新的问题：当用户直接在地址栏输入URL或刷新页面时，服务器可能会找不到对应的资源。

例如，如果用户直接访问http://example.com/about，服务器会认为这是一个请求/about资源的请求，但你的单页面应用只有一个index.html文件，服务器上并没有/about这个资源。

为了解决这个问题，我们需要配置服务器，将所有未匹配到的请求都重定向到index.html。这样，Vue应用就可以接管路由，并正确地渲染对应的组件。

但是，在客户端，我们还需要一种机制来防止用户进入没有权限访问的页面，或者在进入页面之前执行一些必要的操作。这就是路由守卫的作用。

Vue Router提供了三种类型的路由守卫：

全局守卫：在所有路由切换之前或之后执行。

路由独享的守卫：只在特定的路由切换之前执行。

组件内的守卫：在组件被渲染或销毁时执行。

4.1 全局守卫

全局守卫使用router.beforeEach、router.beforeResolve和router.afterEach方法来注册。

router.beforeEach(to, from, next)：在每次路由切换之前执行。to是即将进入的路由对象，from是当前导航正要离开的路由对象，next是一个函数，用于控制路由是否允许切换。

router.beforeEach((to, from, next) => {
  // 检查用户是否已登录
  const isLoggedIn = localStorage.getItem('token')

  if (to.matched.some(record => record.meta.requiresAuth)) {
    // 这个路由需要登录，如果没登录则跳转到登录页面
    if (!isLoggedIn) {
      next({
        path: '/login',
        query: { redirect: to.fullPath } // 保存当前路由，登录后重定向到该路由
      })
    } else {
      next() // 允许进入路由
    }
  } else {
    next() // 允许进入路由
  }
})

router.beforeResolve(to, from, next)：在所有组件内的守卫和异步路由组件被解析之后执行。

router.beforeResolve((to, from, next) => {
  // 在异步组件加载完成后执行一些操作
  console.log('beforeResolve')
  next()
})

router.afterEach(to, from)：在每次路由切换之后执行，不接受next函数。

router.afterEach((to, from) => {
  // 更新页面标题
  document.title = to.meta.title || 'My App'
})

4.2 路由独享的守卫

路由独享的守卫使用beforeEnter选项来注册，只在特定的路由切换之前执行。

const routes = [
  {
    path: '/profile',
    component: Profile,
    beforeEnter: (to, from, next) => {
      // 检查用户是否已登录
      const isLoggedIn = localStorage.getItem('token')

      if (!isLoggedIn) {
        next('/login')
      } else {
        next()
      }
    }
  }
]

4.3 组件内的守卫

组件内的守卫在组件内部定义，包括：

beforeRouteEnter(to, from, next)：在路由进入该组件之前调用。不能访问this，因为组件实例还未被创建。

export default {
  beforeRouteEnter(to, from, next) {
    // 在组件渲染之前获取数据
    getData().then(data => {
      next(vm => {
        // 通过 `vm` 访问组件实例
        vm.data = data
      })
    })
  },
  data() {
    return {
      data: null
    }
  }
}

beforeRouteUpdate(to, from, next)：在当前路由改变，但是该组件被复用时调用。可以访问组件实例this。

export default {
  beforeRouteUpdate(to, from, next) {
    // 当路由参数改变时，重新获取数据
    getData(to.params.id).then(data => {
      this.data = data
      next()
    })
  },
  data() {
    return {
      data: null
    }
  }
}

beforeRouteLeave(to, from, next)：在导航离开该组件的对应路由时调用。可以访问组件实例this。

export default {
  beforeRouteLeave(to, from, next) {
    // 确认用户是否要离开页面
    const answer = window.confirm('确定要离开吗？')
    if (answer) {
      next()
    } else {
      next(false) // 阻止导航
    }
  }
}

5. 服务器配置：至关重要的一步

前面提到过，History Mode需要服务器的支持。你需要将所有未匹配到的请求都重定向到index.html。

不同的服务器有不同的配置方式。下面是一些常见的服务器配置示例：

Apache

在.htaccess文件中添加以下内容：

<IfModule mod_rewrite.c>
  RewriteEngine On
  RewriteBase /
  RewriteRule ^index.html$ - [L]
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule . /index.html [L]
</IfModule>

Nginx

在nginx.conf文件中，找到你的server块，并添加以下内容：

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

Node.js (Express)

使用connect-history-api-fallback中间件：

const express = require('express')
const history = require('connect-history-api-fallback')

const app = express()
app.use(history())
app.use(express.static(__dirname + '/public'))

app.listen(3000, () => {
  console.log('Server listening on port 3000')
})

6. History Mode的优缺点

优点：

URL更美观，更符合传统的多页面应用。

有利于SEO。

缺点：

需要服务器的支持。

配置相对复杂。

7. 总结

History Mode是Vue Router的一个强大特性，它可以让你的单页面应用在浏览器地址栏里看起来更像一个真正的多页面应用。但它也需要服务器的支持和一些额外的配置。希望今天的讲解能够帮助你更好地理解History Mode的原理和使用方法。

记住，前端的世界就像一个不断进化的乐园，新的技术层出不穷。我们要保持学习的热情，不断探索新的知识，才能在这个领域里立于不败之地。

今天的讲座就到这里，谢谢大家！