如何利用 readonly 创建不可变数据?防止全局状态被意外修改的指南

阿墨同学_9982

阿墨同学_9982

2026-05-09

280人浏览

原创

readonly是为响应式对象创建只读代理层,拦截修改操作并在开发环境报错、生产环境静默;必须在数据源头(如父组件provide或store暴露时)用readonly(myRef)或readonly(myObj)提前包装,而非子组件内二次封装。

如何利用 readonly 创建不可变数据?防止全局状态被意外修改的指南

readonly 不是给数据“上锁”,而是创建一个只读代理层,让所有修改操作在开发环境立刻报错、生产环境静默失败。它真正起效的前提是:在数据被消费前就包装好,而不是等传到子组件或模块里再处理。

什么时候必须用 readonly?

核心判断标准:你暴露出去的数据,是否允许接收方改?如果答案是否定的,就必须提前包装。

  • 父组件向子组件传递 reactive 对象或 ref 作 props 时
  • 通过 provide/inject 下发共享配置、主题、用户信息等全局状态时
  • 从 Pinia store 中取出 state 片段,仅用于展示(如 readonly(store.userInfo))
  • 函数参数中接收响应式对象,明确表达“我只读不写”的契约

怎么用才对?关键在包装时机和位置

错误做法:子组件拿到 props 后再调用 readonly(props.user) —— props 本身已是只读代理,再包一层没意义,还可能掩盖原始引用问题。

正确做法:在数据源头封装,确保下游拿到的就是只读版本。

  • 对 ref:用 readonly(myRef),返回只读 ref(.value 赋值被拦截)
  • 对 reactive 对象:用 readonly(myObj),返回深度只读代理(嵌套属性、增删字段、重写整个对象全被拦截)
  • 对 computed:也可直接 readonly(computed(() => ...)),适合下发派生只读状态

示例(父组件 provide):

const config = reactive({ theme: 'dark', lang: 'zh' })
provide('appConfig', readonly(config)) // ✅ 提前包装,子组件拿不到原始引用

readonly 的能力边界:它防不住什么?

它保护的是“访问路径”,不是底层数据本身。以下情况它无能为力:

  • 子组件绕过只读代理,直接拿到原始 reactive 对象(比如通过未包装的 provide 或 inject)
  • 基本类型 ref(如 ref(1))被 readonly 包装后,仍可参与运算(myReadonlyRef.value + 1 没问题),但 .value = 2 会被拦截 —— 这不是 bug,是设计使然
  • 对象内部存在非响应式 plain object(比如 API 返回后直接解构的普通对象),readonly 不会递归使其响应式,自然也无法保护

所以建议配合 defineProps 类型声明 + ESLint 规则(如 vue/no-mutating-props)形成多层防护。

调试与验证:怎么确认它生效了?

打开浏览器控制台,对只读代理尝试修改:

  • myReadonlyRef.value = 'new' → 开发环境报 Set operation on key "value" failed: target is readonly
  • myReadonlyObj.name = 'Bob' 或 delete myReadonlyObj.age → 同样报错
  • 如果没警告,先检查是否传的是原始对象而非 readonly 代理,再确认是否在生产环境(此时静默)
PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

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

下载

相关标签:

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

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3063

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

6723

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

7550

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

7498

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

1063

5

TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

2026.02.13

332

17

TypeScript全栈项目架构与接口规范设计
TypeScript全栈项目架构与接口规范设计

本专题面向全栈开发者,系统讲解基于 TypeScript 构建前后端统一技术栈的工程化实践。内容涵盖项目分层设计、接口协议规范、类型共享机制、错误码体系设计、接口自动化生成与文档维护方案。通过完整项目示例,帮助开发者构建结构清晰、类型安全、易维护的现代全栈应用架构。

2026.02.25

560

17

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

2026.03.13

411

19

TypeScript 全栈开发进阶指南
TypeScript 全栈开发进阶指南

面向有 JavaScript 基础的开发者,深入讲解 TypeScript 的类型系统与全栈开发实践。

2026.06.03

346

29

热门下载

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

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习