必须用 $set 的情况有三种:给响应式对象添加不存在属性、通过索引直接修改响应式数组、设置响应式数组长度;因其能确保新增属性被响应式系统接管,而直接赋值或 Object.assign 会丢失响应性。

Vue 2 中,直接给一个已存在的响应式对象添加新属性(如 obj.newProp = value),该属性不会触发视图更新,因为 Vue 在初始化时只对 已存在 的属性做了 getter/setter 转换。要让新增属性变成响应式,必须用 Vue.set(全局 API)或 this.$set(实例方法)。
什么时候必须用 $set?
以下情况不能跳过 $set:
- 给响应式对象添加一个 原本不存在 的属性(如
this.obj.newField = 'xxx') - 给响应式数组通过索引直接赋值(如
this.list[0] = newValue) - 给响应式数组设置长度(如
this.list.length = 2)
正确写法:$set 的三个参数
this.$set(target, key, value) 接收三个参数:
- target:要修改的对象或数组
- key:属性名(字符串)或数组索引(数字)
- value:要设置的值
✅ 正确示例:
// 对象新增响应式属性
this.$set(this.user, 'age', 28)
// 数组按索引更新(替代 this.items[1] = newItem)
this.$set(this.items, 1, { id: 2, name: 'Vue' })
// 数组 push 本身是响应式的,无需 $set
this.items.push({ id: 3, name: 'Router' })
为什么不能用 Object.assign 或展开运算符?
❌ 错误写法:
// 这样会丢失响应性(创建了新对象,原引用失效)
this.user = Object.assign({}, this.user, { age: 28 })
this.user = { ...this.user, age: 28 }
原因:这些操作生成了全新对象,而 this.user 指向了非响应式的新对象。Vue 无法追踪它的变化。除非你用 Vue.set 或重新用 Vue.observable 包裹,否则视图不会更新。
替代方案:初始化时预留字段
更推荐的做法是在 data 中提前声明所有可能用到的属性,哪怕初始值为 null 或空对象:
data() {
return {
user: {
name: '',
email: '',
age: null // 提前声明,后续直接 this.user.age = 28 即可响应
}
}
}
这样既避免频繁调用 $set,也更利于类型推导和代码可读性。
不复杂但容易忽略 —— 记住:属性必须在 data 初始化阶段就存在,或者通过 $set 显式添加,才能被 Vue 的响应式系统接管。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











