路由配置里的 props 属性用法：教你如何将路由参数解耦到组件 Props

props核心作用是将URL参数自动转为组件props以实现解耦复用；支持布尔模式（映射params）、对象模式（传静态值）、函数模式（灵活处理params/query/类型转换）及命名视图单独配置。

路由配置里的 props 属性，核心作用是把 URL 中的参数“自动转成组件的 props”，让组件不再依赖 $route，从而真正实现解耦、复用和可测试。它不是可有可无的语法糖，而是 Vue Router 设计中提升组件独立性的关键机制。

布尔模式：最简映射，适合 params 场景

当路由含动态段（如 /user/:id），设 props: true，Vue Router 会自动把 params 对象里的字段，按同名方式注入组件 props。

• 路由配置示例：{ path: '/user/:id', component: User, props: true }
• User 组件只需声明：props: ['id'] 或 defineProps({ id: String })
• 注意：它只处理 params，不读取 query（即 ? 后面的参数）

对象模式：传固定值，适合页面级配置

当你需要给组件塞一些与 URL 无关的静态信息，比如默认标题、开关状态或权限标识，就用对象写法。

• 配置示例：{ path: '/admin', component: AdminPanel, props: { readOnly: false, title: '系统管理' } }
• 组件内直接接收：props: ['readOnly', 'title']
• 适用场景：营销页弹窗开关、主题模式、是否启用编辑等固定配置

函数模式：灵活可控，支持 params + query + 类型转换

这是能力最强的方式，接收整个 $route 对象，返回一个纯对象，你可以自由组合、过滤、转换参数。

• 基础写法：props: route => ({ id: Number(route.params.id), q: route.query.q })
• 可做类型转换（字符串 → 数字/布尔）、默认值兜底、合并多个来源数据
• 推荐初学者用显式解构，比如 props: ({ params, query }) => ({ id: params.id, keyword: query.q || '' })，清晰易维护

命名视图下单独控制 props

如果路由用了多个命名视图（如 default 和 sidebar），props 不能全局设置，必须为每个视图单独指定策略。

• 配置示例：{ path: '/user/:id', components: { default: UserProfile, sidebar: UserSidebar }, props: { default: true, sidebar: { showAvatar: true } } }
• 这样 UserProfile 接收 id，UserSidebar 接收固定配置，互不影响
• 避免误操作：不要对未声明的视图名设置 props，否则无效