引言
Vue router给我们提供了两种路由模式,分别是hash模式和history模式。其中默认是使用hash模式,即URL中带有一个#符号,但是处于业务或个人喜爱的差别,Vue router也提供了history模式。但是由于Vue是单页SPA应用,所以每个路由并没有对应的html文件。
什么是history模式
history模式特点
- history模式使用浏览器的history API来管理路由状态,而不是依赖于URL中的哈希。
- 在history模式下,URL看起来更加整洁,没有#符号。例如,http://example.com/user/profile。
- history模式可以在不刷新整个页面的情况下,通过改变URL来切换页面,实现更加流畅的用户体验
history模式的优缺点
优点:
- 更友好的URL:history模式下的URL看起来更加整洁,没有特殊字符(如#),给用户提供了更好的阅读体验。
- 无刷新页面切换:使用history模式时,页面切换不会导致整个页面的刷新,仅仅改变URL,从而实现更加流畅的用户体验。
- 更好的SEO:搜索引擎对于history模式下的页面更容易进行抓取和索引,因为URL更加直观、语义化。
- 路由传参更方便:相比hash模式的URL传参,history模式下的传参更加直观简洁,参数可以直接通过URL的路径进行表示。
缺点:
- 服务器配置要求:使用history模式需要服务器的支持,因为URL改变时,要确保服务器能正确地展示相应的页面,需要进行一些额外的服务器配置。
- 兼容性问题:history模式在一些旧版本的浏览器(如IE9及以下)中不被支持,如果要兼容这些浏览器,可能需要降级为hash模式。
- 开发环境要求:当使用history模式时,需要在开发环境中配置一个服务器来模拟URL的请求,以确保路由正常运行,相比hash模式需要更多的配置。
如何配置Vue Router使用history模式
- 首先我们需要创建一个Vue项目
- 安装Vue Router
npm i vue-router |
- 在Vue项目中配置Vue Router使用history模式
import Vue from 'vue'; | |
import VueRouter from 'vue-router'; | |
Vue.use(VueRouter); | |
const router = new VueRouter({ | |
mode: 'history', | |
routes: [ | |
// 路由配置 | |
] | |
}); | |
export default router; |
- 服务器配置
- 配置服务器,使得所有路由的URL都指向入口页面,我们用nginx配置举例:
server { | |
listen 80; | |
server_name your_domain.com; | |
root /path/to/your/vue_app/dist; | |
index index.html; | |
location / { | |
try_files $uri $uri/ /index.html; | |
} | |
} | |
# 在以上配置中,需要进行以下调整: | |
# 1. server_name:将your_domain.com替换为您的域名。 | |
# 2. root:将/path/to/your/vue_app/dist替换为您的Vue应用的编译输出目录。 | |
# 3. index:确保index.html是您的Vue应用的入口页面。 | |
# 配置解释: | |
# • location /:此处表示对所有的请求都生效。 | |
# • try_files $uri $uri/ /index.html:当请求的文件或目录不存在时,将请求重定向到index.html。这使得所有的路由请求都指向了Vue应用的入口页面,使得应用能够正确地处理动态路由。 |
处理404页面
// 在路由配置中定义一个名为NotFound的路由 | |
const routes = [ | |
// 其他路由配置... | |
{ path: '/404', name: 'NotFound', component: NotFoundComponent }, | |
{ path: '*', redirect: '/404' } | |
] | |
// 创建Vue Router实例并将路由配置应用于它 | |
const router = new VueRouter({ | |
mode: 'history', | |
routes | |
}) | |
// 导航守卫用于捕获404错误 | |
router.beforeEach((to, from, next) => { | |
// 如果目标路由不存在,重定向到404页面 | |
if (to.matched.length === 0) { | |
next('/404'); | |
} else { | |
next(); | |
} | |
}) |
配置publicPath
如果你希望你的Vue应用打完包以后,所有路由的前缀都加上/v1/test,那么你需要对原有的配置做一下修改
vue.config.js
publicPath这里需要判断一下是否为生产环境,如果是生产环境,我们需要加上前缀,这样在读取js、css等文件时才能访问到正确的路径。如果是开发环境,基本URL配置为'/'即可。在开发环境中,我们的应用通常运行在一个本地的开发服务器上(例如:localhost:8080),而不是真实的生产环境服务器(例如:https://www.example.com)。因此,'/'
可以作为根路径来访问我们的应用,而不需要添加任何前缀。
module.exports = { | |
// 部署应用包的基本URL | |
publicPath: process.env.NODE_ENV === 'production' ? '/v1/test/' : '/', | |
devServer: { | |
port: 8080, | |
open: true, | |
proxy: {} | |
} | |
} |
nginx配置
server { | |
listen 80; | |
server_name your_domain.com; | |
root /path/to/your/vue_app/dist; | |
index index.html; | |
location /v1/test { # 这里location需要加上/v1/test | |
try_files $uri $uri/ /index.html; | |
} | |
} |
合集: Vue
分类: Vue2
标签: JavaScript , Vue2 , Vue-router