Vue 3 路由使用完全指南(整体流程)

 更新时间:2026年06月04日 09:10:15   作者:风吹夏回  
这段文章详细介绍了Vue3路由的使用方法,涵盖了创建路由实例、注册路由插件和在组件中使用路由的三步流程,适合Vue3开发者参考和学习,感兴趣的朋友一起看看吧

一、整体流程:三个文件三步走

步骤文件做什么导入什么
1router/index.js创建路由实例createRouter, createWebHistory
2main.js注册路由插件router 实例
3组件使用路由useRouter, useRoute

二、第一步:创建路由实例

// src/router/index.js
import { createRouter, createWebHistory } from 'vue-router'
import Home from '@/views/Home.vue'
import About from '@/views/About.vue'
const routes = [
  {
    path: '/',
    name: 'home',
    component: Home
  },
  {
    path: '/about',
    name: 'about',
    component: About
  }
]
const router = createRouter({
  history: createWebHistory(), // 不带 # 的 URL
  routes
})
export default router

两种路由模式

模式方法URL 示例服务器配置
HistorycreateWebHistory()/about需要
HashcreateWebHashHistory()/#/about不需要

三、第二步:注册路由

// src/main.js
import { createApp } from 'vue'
import App from './App.vue'
import router from './router'
const app = createApp(App)
app.use(router)  // 别忘了这行!
app.mount('#app')

四、第三步:在组件中使用路由

4.1 页面跳转

<script setup>
import { useRouter } from 'vue-router'
const router = useRouter()
// 路由名称跳转(推荐)
router.push({ name: 'about' })
// 路径跳转
router.push('/about')
// 返回上一页
router.back()
router.go(-1)
</script>

4.2 获取路由参数

<script setup>
import { useRoute } from 'vue-router'
const route = useRoute()
// 获取路径参数 /user/:id
console.log(route.params.id)
// 获取查询参数 ?keyword=hello
console.log(route.query.keyword)
</script>

4.3 声明式跳转(模板中)

<template>
  <router-link to="/about">关于我们</router-link>
  <router-link :to="{ name: 'home' }">首页</router-link>
</template>

五、路由出口:<router-view />

路由匹配的组件会渲染在 <router-view /> 的位置:

<!-- App.vue 根组件 -->
<template>
  <div>
    <nav>
      <router-link to="/">首页</router-link>
      <router-link to="/about">关于</router-link>
    </nav>
    <!-- 路由页面在此处显示 -->
    <router-view />
  </div>
</template>

六、完整项目结构

src/
├── main.js            # 注册路由
├── App.vue            # 根组件,包含 <router-view />
├── router/
│   └── index.js       # 路由配置
└── views/
    ├── Home.vue       # 首页
    └── About.vue      # 关于页

七、常见错误排查

现象可能原因
点击跳转没反应router.push 拼写错误
跳转报错 router is undefined组件中没写 const router = useRouter()
整个路由不工作main.js 中没有 app.use(router)
URL 变了但页面没变根组件缺少 <router-view />
导入报错文件路径不正确

八、记忆口诀

创建 → 注册 → 使用,三步缺一不可

  • router.js:创建路由,createRouter
  • main.js:注册插件,app.use(router)
  • 组件中:useRouter() 跳转,useRoute() 取值
    确 |

到此这篇关于Vue 3 路由使用完全指南的文章就介绍到这了,更多相关Vue 3 路由使用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • vue防止花括号{{}}闪烁v-text和v-html、v-cloak用法示例

    vue防止花括号{{}}闪烁v-text和v-html、v-cloak用法示例

    这篇文章主要介绍了vue防止花括号{{}}闪烁v-text和v-html、v-cloak用法,结合实例形式分析了vue.js使用v-text和v-html、v-cloak防止花括号{{}}闪烁的解决方法,需要的朋友可以参考下
    2019-03-03
  • Vue如何配置根目录@(引用路径)

    Vue如何配置根目录@(引用路径)

    这篇文章主要介绍了Vue如何配置根目录@(引用路径),具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-04-04
  • Vue中的同步和异步使用详解

    Vue中的同步和异步使用详解

    这篇文章主要介绍了Vue中的同步和异步使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-08-08
  • vue.js click点击事件获取当前元素对象的操作

    vue.js click点击事件获取当前元素对象的操作

    这篇文章主要介绍了vue.js click点击事件获取当前元素对象的操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-08-08
  • antd+vue实现动态验证循环属性表单的思路

    antd+vue实现动态验证循环属性表单的思路

    今天通过本文给大家分享antd+vue实现动态验证循环属性表单的思路,代码简单易懂,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2021-09-09
  • vue中的依赖注入provide和inject简单介绍

    vue中的依赖注入provide和inject简单介绍

    这篇文章主要介绍了vue中的依赖注入provide和inject简单介绍,provide 选项允许我们指定我们想要提供给后代组件的数据/方法,本文通过组价刷新的案列给大家详细讲解,需要的朋友可以参考下
    2022-11-11
  • 详解.vue文件中监听input输入事件(oninput)

    详解.vue文件中监听input输入事件(oninput)

    本篇文章主要介绍了详解.vue文件中监听input输入事件(oninput),小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-09-09
  • ant-design-vue前端UI库,如何解决Table中时间格式化问题

    ant-design-vue前端UI库,如何解决Table中时间格式化问题

    这篇文章主要介绍了ant-design-vue前端UI库,如何解决Table中时间格式化问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-03-03
  • vue2实现directive自定义指令的封装与全局注册流程

    vue2实现directive自定义指令的封装与全局注册流程

    自定义指令是对普通DOM元素进行的底层操作,它是一种有效的的补充和扩展,不仅可以用于定义任何的dom操作,并且是可以复用的,下面这篇文章主要给大家介绍了关于vue2实现directive自定义指令的封装与全局注册流程的相关资料,需要的朋友可以参考下
    2023-02-02
  • Vue动态组件与异步组件实例详解

    Vue动态组件与异步组件实例详解

    这篇文章主要介绍了Vue动态组件与异步组件,结合实例形式分析了动态组件与异步组件相关概念、功能及使用技巧,需要的朋友可以参考下
    2019-02-02

最新评论