Vue 3 中 shallowRef 怎么结合 readonly 实现不可变浅层

风辰姑娘_1866

风辰姑娘_1866

2026-11-16

778人浏览

原创

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

vue 3 中 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 包裹它,避免深度响应开销。推荐方式:

Vue工具箱(免费版)
Vue工具箱(免费版)

规避 Vue 3 常见陷阱:响应式、ref 与 reactive、computed 时机与组合式 API 优选实践。

下载
  • 手动冻结 + 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实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

vue.js vue vue 3

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
vue2.0和3.0区别
vue2.0和3.0区别

vue2.0和3.0区别:vue2的响应式原理是利⽤“Object.defineProperty()”对数据进⾏劫持结合发布订阅模式的⽅式来实现,vue3中使⽤了es6的proxy API对数据代理,实现对数据的监控。本专题为大家提供vue2.0和3.0区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.17

1774

5

vue3的生命周期有哪些
vue3的生命周期有哪些

vue3的生命周期:1、beforecreate;2、created;3、beforemount;4、mounted;5、beforeupdate;6、updated;7、beforedestroy;8、destroyed;9、activated;10、deactivated等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

12682

5

Vue3组合式API与组件开发实战
Vue3组合式API与组件开发实战

本专题讲解 Vue 3 组合式 API 的核心概念与应用技巧,深入分析响应式系统、生命周期管理、组件设计与复用策略。通过完整项目案例,指导前端开发者实现高性能、结构清晰的 Vue 应用,提升开发效率与代码可维护性。

2026.02.10

356

23

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

100

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

60

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

60

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

160

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

120

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

120

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Vue 教程
Vue 教程

共42课时 | 17.5万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.4万人学习

Vue.js 微实战--十天技能课堂
Vue.js 微实战--十天技能课堂

共18课时 | 1.7万人学习