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

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 代理,再确认是否在生产环境(此时静默)










