Vue 3 路由使用完全指南

Vue 3 路由使用完全指南


### 文章目录

  • [Vue 3 路由使用完全指南](#文章目录 Vue 3 路由使用完全指南 @[toc] 一、整体流程:三个文件三步走 二、第一步:创建路由实例 两种路由模式 三、第二步:注册路由 四、第三步:在组件中使用路由 4.1 页面跳转 4.2 获取路由参数 4.3 声明式跳转(模板中) 五、路由出口:<router-view /> 六、完整项目结构 七、常见错误排查 八、记忆口诀)
  • [@toc](#文章目录 Vue 3 路由使用完全指南 @[toc] 一、整体流程:三个文件三步走 二、第一步:创建路由实例 两种路由模式 三、第二步:注册路由 四、第三步:在组件中使用路由 4.1 页面跳转 4.2 获取路由参数 4.3 声明式跳转(模板中) 五、路由出口:<router-view /> 六、完整项目结构 七、常见错误排查 八、记忆口诀)
  • [一、整体流程:三个文件三步走](#文章目录 Vue 3 路由使用完全指南 @[toc] 一、整体流程:三个文件三步走 二、第一步:创建路由实例 两种路由模式 三、第二步:注册路由 四、第三步:在组件中使用路由 4.1 页面跳转 4.2 获取路由参数 4.3 声明式跳转(模板中) 五、路由出口:<router-view /> 六、完整项目结构 七、常见错误排查 八、记忆口诀)
  • [二、第一步:创建路由实例](#文章目录 Vue 3 路由使用完全指南 @[toc] 一、整体流程:三个文件三步走 二、第一步:创建路由实例 两种路由模式 三、第二步:注册路由 四、第三步:在组件中使用路由 4.1 页面跳转 4.2 获取路由参数 4.3 声明式跳转(模板中) 五、路由出口:<router-view /> 六、完整项目结构 七、常见错误排查 八、记忆口诀)
  • [两种路由模式](#文章目录 Vue 3 路由使用完全指南 @[toc] 一、整体流程:三个文件三步走 二、第一步:创建路由实例 两种路由模式 三、第二步:注册路由 四、第三步:在组件中使用路由 4.1 页面跳转 4.2 获取路由参数 4.3 声明式跳转(模板中) 五、路由出口:<router-view /> 六、完整项目结构 七、常见错误排查 八、记忆口诀)
  • [三、第二步:注册路由](#文章目录 Vue 3 路由使用完全指南 @[toc] 一、整体流程:三个文件三步走 二、第一步:创建路由实例 两种路由模式 三、第二步:注册路由 四、第三步:在组件中使用路由 4.1 页面跳转 4.2 获取路由参数 4.3 声明式跳转(模板中) 五、路由出口:<router-view /> 六、完整项目结构 七、常见错误排查 八、记忆口诀)
  • [四、第三步:在组件中使用路由](#文章目录 Vue 3 路由使用完全指南 @[toc] 一、整体流程:三个文件三步走 二、第一步:创建路由实例 两种路由模式 三、第二步:注册路由 四、第三步:在组件中使用路由 4.1 页面跳转 4.2 获取路由参数 4.3 声明式跳转(模板中) 五、路由出口:<router-view /> 六、完整项目结构 七、常见错误排查 八、记忆口诀)
  • [4.1 页面跳转](#文章目录 Vue 3 路由使用完全指南 @[toc] 一、整体流程:三个文件三步走 二、第一步:创建路由实例 两种路由模式 三、第二步:注册路由 四、第三步:在组件中使用路由 4.1 页面跳转 4.2 获取路由参数 4.3 声明式跳转(模板中) 五、路由出口:<router-view /> 六、完整项目结构 七、常见错误排查 八、记忆口诀)
  • [4.2 获取路由参数](#文章目录 Vue 3 路由使用完全指南 @[toc] 一、整体流程:三个文件三步走 二、第一步:创建路由实例 两种路由模式 三、第二步:注册路由 四、第三步:在组件中使用路由 4.1 页面跳转 4.2 获取路由参数 4.3 声明式跳转(模板中) 五、路由出口:<router-view /> 六、完整项目结构 七、常见错误排查 八、记忆口诀)
  • [4.3 声明式跳转(模板中)](#文章目录 Vue 3 路由使用完全指南 @[toc] 一、整体流程:三个文件三步走 二、第一步:创建路由实例 两种路由模式 三、第二步:注册路由 四、第三步:在组件中使用路由 4.1 页面跳转 4.2 获取路由参数 4.3 声明式跳转(模板中) 五、路由出口:<router-view /> 六、完整项目结构 七、常见错误排查 八、记忆口诀)
  • [五、路由出口:`<router-view />`](#文章目录 Vue 3 路由使用完全指南 @[toc] 一、整体流程:三个文件三步走 二、第一步:创建路由实例 两种路由模式 三、第二步:注册路由 四、第三步:在组件中使用路由 4.1 页面跳转 4.2 获取路由参数 4.3 声明式跳转(模板中) 五、路由出口:<router-view /> 六、完整项目结构 七、常见错误排查 八、记忆口诀)
  • [六、完整项目结构](#文章目录 Vue 3 路由使用完全指南 @[toc] 一、整体流程:三个文件三步走 二、第一步:创建路由实例 两种路由模式 三、第二步:注册路由 四、第三步:在组件中使用路由 4.1 页面跳转 4.2 获取路由参数 4.3 声明式跳转(模板中) 五、路由出口:<router-view /> 六、完整项目结构 七、常见错误排查 八、记忆口诀)
  • [七、常见错误排查](#文章目录 Vue 3 路由使用完全指南 @[toc] 一、整体流程:三个文件三步走 二、第一步:创建路由实例 两种路由模式 三、第二步:注册路由 四、第三步:在组件中使用路由 4.1 页面跳转 4.2 获取路由参数 4.3 声明式跳转(模板中) 五、路由出口:<router-view /> 六、完整项目结构 七、常见错误排查 八、记忆口诀)
  • [八、记忆口诀](#文章目录 Vue 3 路由使用完全指南 @[toc] 一、整体流程:三个文件三步走 二、第一步:创建路由实例 两种路由模式 三、第二步:注册路由 四、第三步:在组件中使用路由 4.1 页面跳转 4.2 获取路由参数 4.3 声明式跳转(模板中) 五、路由出口:<router-view /> 六、完整项目结构 七、常见错误排查 八、记忆口诀)

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

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

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

javascript 复制代码
// 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 示例 服务器配置
History createWebHistory() /about 需要
Hash createWebHashHistory() /#/about 不需要

三、第二步:注册路由

javascript 复制代码
// 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 页面跳转

vue 复制代码
<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 获取路由参数

vue 复制代码
<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 声明式跳转(模板中)

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

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

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

vue 复制代码
<!-- 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() 取值
    确 |

相关推荐
SoaringHeart20 分钟前
Flutter最佳实践:用 flutter_html 渲染富文本
前端·flutter
Flynt2 小时前
Chrome给AI编程助手塞了203篇前端规范,我拆包实测:检索0.77秒是真快,扫描器有点挑食
前端·chrome·ai编程
北城笑笑2 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
程序员韩星2 小时前
OpenAI 兼容接口返回 404,先查请求地址,再查模型名
前端·人工智能·http
Patrick_Wilson2 小时前
构建通过了,为什么有些浏览器还会白屏?
前端·javascript·浏览器
其实防守也摸鱼3 小时前
用 Claude Code 重构遗留系统:从评估到落地的完整指南
前端·网络·人工智能·chrome·安全·重构
七仔啊3 小时前
CNC计算机数控加工模拟器
前端
张一凡934 小时前
你的 AGENTS.md,真的管到模型写代码了吗?
前端·后端·agent
Brookty4 小时前
CSS基础知识(一):选择器、优先级、层叠与继承、边框属性及盒模型
前端·css
颜进强4 小时前
微信小微AI-灰度与命中排查|代码全对、版本已发,为什么同事就是问不中?
前端·ai编程·全栈