Vue Router 通过 routes 的 props 选项传递参数,支持布尔模式(映射 params)、对象模式(传静态值)、函数模式(加工 route 数据)及命名视图分别配置,提升组件解耦性与可测试性。

Vue Router 在路由配置中传递 props 给组件,核心是通过 routes 配置项里的 props 选项,而不是在跳转时手动传。它让组件不再依赖 $route,从而实现解耦、复用和可测试性。
布尔模式:自动映射 params
设置 props: true,Vue Router 会把当前路由的 params(路径参数)自动作为 props 传入组件。
- 路由配置示例:
{ path: '/user/:id', component: User, props: true } - 组件内只需声明接收:
props: ['id']或defineProps({ id: String }) - URL
/user/123→ 组件收到id = '123'(字符串类型)
对象模式:传固定静态值
当需要给组件传不随 URL 变化的固定配置时,直接写一个对象。
- 路由配置示例:
{ path: '/admin', component: AdminPanel, props: { canEdit: false, title: '只读后台' } } - 组件内声明:
props: ['canEdit', 'title'] - 适合传权限开关、页面标题、默认主题等“路由无关”的配置
函数模式:灵活处理 & 类型转换
用函数返回 props 对象,可以加工 route.params、route.query,甚至合并、转换类型。
立即学习“前端免费学习笔记(深入)”;
- 路由配置示例:
{ path: '/search', component: SearchList, props: route => ({ q: route.query.q, page: Number(route.query.page) || 1 }) } - URL
/search?q=vue&page=2→ 组件收到q = 'vue'、page = 2(数字) - 特别适合把 query 字符串转成布尔/数字,或拼接多个参数生成新 prop
命名视图场景下的 props 配置
如果路由用了 components(多个命名视图),必须为每个视图单独指定 props 策略。
- 配置示例:
{ path: '/user/:id', components: { default: UserProfile, sidebar: UserSidebar }, props: { default: true, sidebar: { showActions: true } } } - 主视图接收
id,侧边栏接收固定配置showActions



















