Vue组件Props设计应语义化命名（camelCase）、对象式定义（含type/required/default/validator）、结构扁平化（聚合相关配置为对象）、避免解构破坏响应性。
Vue 组件的 Props 设计直接影响组件的可复用性、可维护性和健壮性。好的 Props 结构不是堆参数，而是有逻辑、有边界、有约束的数据接口。
语义化命名 + camelCase 命名规范
Props 名称应准确表达其用途，使用小驼峰（camelCase）写法，避免中划线或下划线，也避开 HTML 或 Vue 内置属性（如 class、style、ref、key）。
- ✅ 推荐：userName、maxItems、isDisabled
- ❌ 避免：user-name（模板中可用，但 JS 中无法直接访问）、class（覆盖原生行为）、data（与 data 选项冲突）
对象式定义 + 显式类型与约束
永远优先使用对象形式定义 Props，杜绝数组形式（无校验、无默认值、不支持 TypeScript）。
- type：明确指定类型（String、Number、Boolean、Array、Object、Function、Promise 等），必要时用 Object as PropType<MyType> 做类型断言
- required：显式标记是否必传，避免运行时静默失败
- default：基础类型可直接赋值；引用类型（Array/Object）必须用工厂函数 () => [] 或 () => ({})
- validator：对取值范围、格式、业务规则做校验，比如 status 只允许 'success' | 'error' | 'warning'
结构扁平 + 复杂数据封装为对象
避免传递过多独立 Props（如 title、subtitle、icon、size、color、disabled…），把相关配置聚合成一个对象 Props。
立即学习“前端免费学习笔记（深入）”；
- ❌ 冗余写法：title、desc、iconName、themeColor
- ✅ 聚合写法：headerConfig，类型为 { title: string; desc?: string; icon?: string; color?: string }
- 好处：减少 Props 数量、增强语义、便于扩展、利于 TypeScript 类型推导
响应式安全 + 解构注意事项
Props 是只读响应式代理，解构会丢失响应性——这是高频踩坑点。
- 在 <script setup> 中使用 defineProps 后，直接解构 const { title, count } = props → title 不再响应
- 正确做法：保持对 props.title 的访问；如需解构，配合 getter 使用：watch(() => props.title, ...)
- 传参给外部函数时，不要直接传解构值，改用 () => props.title 包装，确保追踪更新
