vue 3 props规范三点：类型明确（基础类型直写，复杂结构用proptype）、必传与默认值互斥（对象/数组默认值须为工厂函数）、自定义校验兜底业务规则，模板传值必须用v-bind冒号语法。
Vue 3 单文件组件中规范 Props，核心就三点：类型必须明确、必传要有约束、默认值要安全。不写清楚，运行时就容易报 Cannot read property 'xxx' of undefined，尤其在多人协作或后期迭代时，问题会集中爆发。
类型标注：基础类型直写，复杂结构用 PropType
基础类型（String、Number、Boolean、Array、Object、Function）可直接作为 type 值；但凡涉及具体结构，就必须显式标注，否则 TypeScript 编译通过、运行时校验却失效：
- 数组元素带类型：用
Object as PropType<user></user>或更简洁的泛型写法users: User[]（TS 项目推荐） - 对象字段固定：用
Object as PropType，比裸写Object更安全、编辑器提示更准 - 枚举状态：优先用字面量联合类型，如
status: 'idle' | 'loading' | 'success'，既防错又支持自动补全 - 函数签名不能丢：写成
onSubmit: Function as PropType void>，避免参数类型丢失
必传与默认值：互斥且有规则
required 和 default 不能共存——这是硬性逻辑：既然有默认值，就不该强制要求父组件传；反之，标了 required 就不该设 default。
- 关键参数必传：用
required: true（运行时环境会警告），或 TS 中用非空断言apiEndpoint!: string - 对象/数组默认值必须是工厂函数：
config: { type: Object, default: () => ({ theme: 'light' }) }，否则多个实例共享同一引用，引发状态污染 - 基础类型默认值可直写：
size: { type: String, default: 'medium' }、disabled: { type: Boolean, default: false }
自定义校验：兜住业务规则，不止于“像不像”
type 只检查“是不是字符串”，validator 才管“是不是合法的 URL”或“是否在允许范围内”：
- URL 必须 HTTPS：
apiUrl: { type: String, validator: v => v && v.startsWith('https://') } - 数字范围限制：
score: { type: Number, validator: v => v >= 0 && v - 对象必含字段：
config: { type: Object, validator: v => v && 'baseUrl' in v && typeof v.baseUrl === 'string' } - 验证逻辑建议抽离复用，比如
isValidEmail、isNonEmptyArray，避免各处重复写正则
模板传值：冒号（v-bind）不能省
没加冒号就是传字符串字面量，哪怕你写的是 true 或 123：
- ❌ 错误：
<user-card is-active="true" count="99"></user-card>→ 传的是字符串"true"和"99" - ✅ 正确：
<user-card :is-active="true" :count="99"></user-card>→ 类型才对得上 - 表单输入绑定需注意：用户输入默认是字符串，传给需要 Number 的 prop 前，建议在父组件做转换或子组件用 computed 转换
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
