Vue3中直接修改reactive代理对象的属性可触发更新,但必须操作代理对象而非原始对象;解构需用toRefs保持响应性,Object.assign可行而直接赋值会丢失响应式。

直接修改 reactive 对象的属性就能触发界面更新,这是 Vue3 响应式系统默认行为,前提是操作方式符合 Proxy 的拦截规则。
必须通过响应式代理对象修改
reactive 返回的是一个 Proxy 代理对象,不是原始对象。只有对这个代理对象的操作才会被拦截并触发更新。
- ✅ 正确:用 reactive({}) 创建后,始终操作返回的对象,比如
state.count++、state.user.name = '李四' - ❌ 错误:把原始对象赋值给 reactive,再改原始对象,比如
const raw = { count: 0 }; const state = reactive(raw); raw.count = 1;—— 这不会更新视图
支持所有常规属性操作
Proxy 拦截了读、写、删、遍历等行为,所以以下写法都有效:
使用 assistant-ui 构建具有可重用线程、运行时、消息组件和模型/提供者适配器的生产级 React 聊天界面。
- 修改已有属性:
state.title = '新标题' - 新增属性:
state.newField = true(响应式新增) - 删除属性:
delete state.unused(会触发更新) - 数组操作:
state.list.push('item')、state.list[0] = 'first'、state.list.length = 0 - 嵌套对象属性:
state.profile.address.city = '上海'(深层响应式,无需额外处理)
避免解构破坏响应性
解构会脱离 Proxy 环境,导致后续赋值不触发更新。
- ❌ 危险:
const { count } = state; count++——count是普通数字,修改无效 - ✅ 安全:
const { count } = toRefs(state); count.value++或直接用state.count++ - ? 模板中可直接用
{{ state.count }},无需 .value;但 script 中解构需配合 toRefs
注意边界情况
有些 JS 操作无法被 Proxy 捕获,需手动或换方式处理:
- Object.assign(state, { a: 1, b: 2 }) ✅ 可以,因为是批量赋值到代理对象上
- state = { ...state, a: 1 } ❌ 不行,这等于重新赋值变量,丢失响应式引用
- 替换整个嵌套对象时,推荐用
Object.assign(state.nested, newData)而非state.nested = newData(后者会断开响应链,除非 newData 也是 reactive)










