useRoute 是 Vue 3 组合式 API 中获取响应式路由信息的核心方法,返回只读对象,含 params、query、path 等自动更新字段;需手动类型转换并配合 useRouter 实现安全导航。

在 Vue 3 组合式 API 中,useRoute 是获取当前路由信息最直接、响应式的方式。它返回一个只读的响应式对象,包含 params、query、path、name、meta 等关键属性,所有字段都会随 URL 变化自动更新。
基础用法:解构参数并响应式使用
在组件 setup() 中调用 useRoute(),即可访问动态参数和查询参数:
-
动态路由参数(如
/user/:id) → 从route.params获取,类型为Record -
URL 查询参数(如
?q=vue&page=2) → 从route.query获取,类型同上 - 参数值始终是字符串(或字符串数组),需手动转换类型,例如
Number(route.params.id)
安全转换参数:避免 NaN 或 undefined
直接读取 route.params.id 得到的是字符串,若用于计算或接口请求,建议封装转换逻辑:
- 用
computed包裹,提升复用性与响应性:const userId = computed(() => Number(route.params.id) || 0) - 对可能缺失的查询参数设默认值:
const page = Number(route.query.page) || 1 - 配合 TypeScript 接口声明预期结构,再做运行时校验(如用 zod 解析),增强类型安全
配合 useRouter 实现导航跳转
useRoute 负责“读”,useRouter 负责“写”。两者常一起使用:
- 获取当前 ID 后跳转到详情页:
const route = useRoute(); const router = useRouter();<br>const goToDetail = () => router.push(`/post/${route.params.id}`); - 用命名路由跳转更可靠:
router.push({ name: 'UserProfile', params: { id: route.params.id } }) - 注意:
params必须严格匹配路由配置中的动态段名称(如:id),否则跳转失败
常见误区提醒
这些细节容易被忽略但影响稳定性:
-
useRoute()返回的对象不可写,不能直接修改route.params;要改地址必须用router.push - 不要在
watch中监听整个route对象(开销大),应监听具体字段,如watch(() => route.params.id, ...) - 服务端渲染(SSR)或首屏直出时,
useRoute()仍可安全使用,其响应式机制在 SSR 和客户端都一致
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










