shallowRef 本身不提供不可变性,仅对 .value 赋值做响应式追踪;需配合 Object.freeze() 浅冻结原始对象后再用 shallowRef + readonly 包裹,才能实现浅层不可变语义。

shallowRef 本身不提供不可变性,它只是对值做浅层响应式包裹(即只追踪 ref.value 的赋值,不递归代理内部属性)。要实现“不可变浅层”,需配合 readonly —— 但注意:readonly 作用于 shallowRef 时,保护的是 ref 对象本身,而非其 .value 指向的原始对象。
为什么不能直接 readonly(shallowRef(obj))?
因为 readonly 包裹的是 ref 实例,它会让 .value 变成只读访问器(无法重新赋值),但若 .value 是一个普通对象,其内部属性仍可被修改:
const obj = { a: 1, b: { c: 2 } };
const sr = shallowRef(obj);
const roSr = readonly(sr);
roSr.value.a = 99; // ✅ 允许!shallowRef + readonly 不阻止内部属性修改
roSr.value = {}; // ❌ 报错!readonly 阻止 .value 被重新赋值
正确做法:先 readonly 再 shallowRef(或用 custom ref)
目标是让 .value 指向一个真正不可变的对象(浅层冻结),再用 shallowRef 包裹它,避免深度响应开销。推荐方式:
-
手动冻结 + shallowRef:对原始对象调用
Object.freeze()(仅浅层),再传给shallowRef -
搭配
readonly提供双重保障:防止外部重新赋值.value,也防止意外修改内部
示例:
const original = { x: 1, y: 2, nested: { z: 3 } };
const frozen = Object.freeze({ ...original }); // 浅冻结:x/y 不可改,nested 对象本身仍可改其属性(但通常你已约定不深改)
const sr = shallowRef(frozen);
const immutableShallowRef = readonly(sr); // .value 不可重赋,且 .value 已冻结 → 浅层不可变
// 使用效果:
immutableShallowRef.value.x = 100; // ❌ TypeError: Cannot assign to read only property 'x'
immutableShallowRef.value.nested.z = 999; // ❌ 同样报错(因 nested 也被 freeze)
进阶:封装成工具函数
避免每次手写 Object.freeze,可封装为 shallowReadonlyRef:
import { shallowRef, readonly } from 'vue';
export function shallowReadonlyRef<t extends object>(value: T): Readonly<shallowref>>> {
return readonly(shallowRef(Object.freeze({ ...value } as T)));
}
// 使用:
const state = shallowReadonlyRef({ count: 0, name: 'Alice' });
state.value.count = 1; // ❌ 报错
state.value = { count: 2 }; // ❌ 报错
</shallowref></t>
注意事项
-
Object.freeze()是浅层的,嵌套对象需自行冻结(或用deepFreeze,但违背“浅层”初衷) -
shallowRef在.value被替换时才触发更新;冻结后无法替换,所以该 ref 实际是静态常量 - 若需响应式更新能力 + 浅层不可变语义,应考虑
computed(() => Object.freeze(...)),但性能略低
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











