vue 3 的 中,userouter 和 usestore(pinia/vuex)可直接调用实现路由与状态管理;userouter 用于导航和获取路由实例,当前路由需用 useroute;pinia 的 usestore 返回响应式 store,vuex 的 usestore 需配合 computed 保持响应式。

在 Vue 3 的 setup 语法糖(<script setup></script>)中,路由和状态管理的使用比 Options API 更简洁直接。核心是通过组合式 API 提供的 useRouter 和 useStore(Vuex)或 useStore(Pinia),它们都是可直接调用的函数,无需手动注入或 this 访问。
useRouter:获取和操作路由实例
useRouter 返回当前应用的 Router 实例,用于编程式导航、获取路由信息等。它只能在已安装 Vue Router 的组件中使用(即在 setup 上下文中),且不能在异步 setup(如 async setup())中直接调用(需配合 onBeforeMount 等生命周期钩子)。
- 跳转页面:
router.push('/home')、router.replace({ name: 'User', params: { id: 123 } }) - 返回上一页:
router.back()、router.go(-1) - 监听路由变化(推荐用
useRoute响应式获取当前路由):watch(() => route.path, () => {...})
注意:useRouter 不提供当前路由信息,当前路由需用 useRoute() 获取(返回响应式对象,含 params、query、fullPath 等)。
useStore(Pinia):推荐的状态管理方式
Vue 官方推荐 Pinia 作为 Vuex 的替代。在 <script setup></script> 中,useStore 直接导入并调用即可获取指定 store 实例:
- 定义 store(
stores/user.ts):export const useUserStore = defineStore('user', { state: () => ({ name: '' }), actions: { setName(n) { this.name = n } } }) - 组件内使用:
import { useUserStore } from '@/stores/user'; const userStore = useUserStore(); - 读写状态:
{{ userStore.name }}、userStore.setName('Alice')(自动响应式)
Pinia 的 store 是响应式的,无需 mapState 或 mapActions,也不需要额外解构 —— 直接访问属性和方法即可。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
useStore(Vuex):兼容旧项目的方式
若仍在使用 Vuex 4(适配 Vue 3),useStore 需从 vuex 导入,并确保根组件已传入 store 选项:
- 导入与调用:
import { useStore } from 'vuex'; const store = useStore(); - 读取状态:
store.state.count或store.getters.doneTodos(建议配合computed保持响应式) - 触发变更:
store.commit('increment')、store.dispatch('fetchUser')
注意:Vuex 的 state 本身非响应式(除非用 computed(() => store.state.xxx) 包裹),否则更新不会触发视图重绘。
常见搭配技巧
实际开发中常将路由与状态结合使用:
- 路由参数驱动状态加载:
const route = useRoute(); const store = useUserStore(); onMounted(() => store.fetchById(route.params.id)) - 导航守卫逻辑抽离:在 store 中定义
checkAuthaction,配合router.beforeEach使用 - 避免重复请求:用
route.name+store.hasLoaded判断是否已初始化数据
不复杂但容易忽略的是:所有组合式函数都必须在 setup 同步执行阶段调用,不可包裹在普通函数或事件回调里(否则失去响应式上下文)。










