Vue 中的 readonly 与 shallowReadonly 如何保障数据不可变性?

阿浩大大_2201

阿浩大大_2201

2026-06-24

757人浏览

原创

readonly 提供深层只读语义保障,shallowreadonly 仅保护顶层属性;二者均通过 proxy 拦截赋值删除操作,开发环境警告、生产环境静默失败,不冻结原始数据但防止意外修改。

vue 中的 readonly 与 shallowreadonly 如何保障数据不可变性?

Vue 中的 readonly 和 shallowReadonly 并不真正“冻结”数据,而是通过 Proxy 拦截赋值、删除等操作,在开发环境发出警告、生产环境静默失败,从而在运行时提供**语义级不可变保障**——它们不阻止原始数据变更,但能有效防止意外修改,配合合理设计可达成接近不可变的效果。

readonly:深层只读,适合强约束场景

它递归代理整个响应式对象(包括嵌套对象、数组及其元素),对任意层级的属性赋值(如 obj.nested.count = 5)、push、delete 等操作均被拦截:

  • 开发模式下抛出明确警告,提示“Cannot assign to read only property”
  • 生产模式下静默忽略,不报错也不生效,视图仍能响应原始数据变化
  • 返回的代理仍是响应式的——原始数据更新,readonly 代理读取值同步更新
  • TypeScript 类型中所有属性自动标记为 readonly,提升类型安全

shallowReadonly:仅保护顶层,保留深层可变性

它只拦截对象自身第一层属性的操作,嵌套结构(哪怕已是 reactive)保持原样,不递归包装:

Ainative Vue Sdk
Ainative Vue Sdk

使用 `@ainative/vue-sdk` 为 Vue 3 应用添加 AI 聊天功能。适用于以下场景:(1) 安装 `@ainative/vue-sdk`,(2) 在 Vue 组件中使用 `useChat` 组合式函数,(3) 提供……

下载
  • obj.name = 'new' 会警告并失败
  • obj.config.timeout = 10000 成功(只要 config 是普通或 reactive 对象)
  • 适用于“防替换、不禁修改”的场景,比如组件接收配置对象但允许内部状态动态更新
  • 比 readonly 开销更低,尤其面对大型嵌套结构时

关键注意事项与加固手段

仅靠这两个 API 不足以构建绝对不可变系统,需结合其他策略:

  • 解构后赋值无法拦截:const { name } = readonlyObj; name = 'x' 只改局部变量,不触发警告
  • 嵌套普通对象不受保护:若 obj.nested 是普通对象,shallowReadonly 不处理它,readonly 才会递归代理
  • 建议搭配 computed 封装派生状态:用 computed(() => ({ ... })) + readonly() 避免暴露原始引用
  • 对关键状态,应在业务逻辑层主动校验:用 watch 监听原始 ref/reactive,发现异常修改时记录或中断

何时选哪个?一句话判断

想让整个数据树都“碰不得”,选 readonly;只想锁住顶层字段(比如防止 props.config = newConfig),同时允许 config.loading = true 这类内部更新,就用 shallowReadonly。

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关文章

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

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

下载

相关标签:

vue vue 响应式

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系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

1674

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

12042

5

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

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

2026.02.10

316

23

PixTV官网入口地址合集
PixTV官网入口地址合集

本专题汇总了 PixTV AI 一站式视频创作平台的官方入口与使用教程。无需下载软件,浏览器直接访问即可使用。平台将剧本、图像、视频、声音与剪辑整合在“无限画布”中,接入 GPT Image 2.5、Seedance 2.5 等头部模型。本专题整理了从新建画布、角色锚定、分镜拆分到视频生成与导出的完整操作指南,助你快速上手 AI 短剧与漫剧创作。

2026.10.10

100

15

Kratos框架HTTP与gRPC服务开发教程
Kratos框架HTTP与gRPC服务开发教程

本专题围绕Kratos框架双协议服务开发,涵盖HTTP路由与处理器编写、参数获取、gRPC服务实现与客户端调用、metadata上下文传递、encoding编解码注册、统一响应封装、超时控制与流式响应实现方法。

2026.10.10

40

15

Kratos框架Protobuf接口定义与代码生成合集
Kratos框架Protobuf接口定义与代码生成合集

本专题讲解Kratos框架接口定义体系,涵盖proto编写规范、proto add/client/server生成命令、http注解路由、validate校验、OpenAPI文档生成、跨服务proto复用与兼容性设计。

2026.10.10

20

15

C++虚函数怎么定义和调用
C++虚函数怎么定义和调用

C++虚函数是实现运行时多态的重要机制。本专题从virtual关键字的基本用法入手,介绍基类与派生类之间的函数重写、基类指针调用派生类方法,以及动态绑定的执行过程,帮助初学者掌握虚函数的核心语法。

2026.10.10

40

26

C++类与对象的封装方法教程
C++类与对象的封装方法教程

C++封装是面向对象编程的核心特性之一,通过类将数据与操作数据的函数组织在一起,并利用访问权限控制外部访问。本专题介绍类的定义、成员变量、成员函数以及public、private和protected的使用方法,帮助初学者掌握封装的基本原理。

2026.10.10

40

32

C++构造函数定义与调用方法
C++构造函数定义与调用方法

C++构造函数用于初始化类对象,是面向对象编程的重要基础。本专题从构造函数的定义、声明和调用入手,介绍默认构造函数、带参数构造函数、拷贝构造函数及成员初始化列表,帮助初学者掌握对象创建与初始化的基本方法。

2026.10.10

40

16

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app快速上手
uni-app快速上手

共0课时 | 0人学习

Vue 教程
Vue 教程

共42课时 | 17.1万人学习

Vue3.x 工具篇--十天技能课堂
Vue3.x 工具篇--十天技能课堂

共26课时 | 2.5万人学习