shallowRef 在 TypeScript 中需显式标注泛型类型，避免字面量推导导致不可扩展；支持联合类型（如 HTMLInputElement | null）；其 .value 类型即泛型 T，不递归响应但类型校验仍全量。
shallowRef 在 TypeScript 中规范数据类型，关键在于明确泛型约束、避免依赖自动推导、并理解它与 ref 的类型差异——它不递归响应内部属性，但类型仍需精准表达。
必须显式标注泛型，不能靠字面量推导
shallowRef 对象字面量时，TS 默认会推导为具体字面量类型（如 { name: 'a', list: [] } → { name: 'a'; list: never[] }），后续无法添加新字段或修改结构，且失去类型灵活性。
- ✅ 推荐写法：用接口或类型别名定义结构，再传入泛型
interface UserInfo { id: number; name: string; profile: Record<string, any> }const user = shallowRef<UserInfo>({ id: 1, name: 'Alice', profile: {} }) - ❌ 避免写法：
const user = shallowRef({ id: 1, name: 'Alice' })→ 类型是{ id: number; name: string }字面量，不可扩展
处理可能为 null 或 undefined 的场景
shallowRef 常用于暂存未初始化的 DOM 元素或组件实例，此时初始值常为 null，需在泛型中包含联合类型。
- ✅ 显式声明可空类型：
const inputEl = shallowRef<HTMLInputElement | null>(null) - ✅ 组件实例引用：
const childComp = shallowRef<InstanceType<typeof ChildComponent> | null>(null) - ⚠️ 注意：不要写
shallowRef<null>(null)，这会让后续赋值为真实对象时报类型错误
与 ref 的类型行为对比要清楚
ref 的泛型 Ref<T> 包裹后类型是 { value: T }；shallowRef 同样返回 ShallowRef<T>，但它的 .value 类型就是 T，不额外深层代理——类型上不体现“浅”与“深”，只靠泛型定义语义。
立即学习“前端免费学习笔记（深入）”；
- 两者都需保证
.value的读写类型一致 - 若 T 是对象，shallowRef 不会把
T内部属性转成响应式，但类型检查仍按T全量校验 - 例如：
shallowRef<{ a: number; b: { c: string } }>(...)中，.value.a可改，.value.b.c也可读写，但修改b.c不触发更新——类型系统不管响应逻辑，只管你有没有这个属性
搭配 toRef / toRefs 时保持类型穿透
从 shallowRef 解构属性本身不常用（因它通常只包一层），但若与 reactive 对象混用，toRef 能安全提取并保留 shallowRef 的原始类型语义。
- 例如：
const state = shallowRef({ count: 0, items: [] as string[] })
用const countRef = toRef(state.value, 'count')→ 类型是Ref<number>，不是ShallowRef<number> - 若需保持 shallow 语义，应直接操作
state.value.count，不推荐解构出新 shallowRef
