浅响应式的概念:与深层响应式的区别

Vue 的响应式系统默认是深层响应式的——当你用 reactiveref 包裹对象时,Vue 会递归地将所有嵌套属性转换为响应式代理。比如:

import { ref } from 'vue'
const obj = ref({ a: { b: 1 } })
obj.value.a.b = 2 // 触发更新(深层响应式)

这种行为很方便,但也会带来性能开销:如果对象非常大(比如包含 thousands 条数据的列表),或者内部状态由外部库管理(比如 axios 响应、第三方状态库),深层代理会浪费资源。

浅响应式(Shallow Reactivity)就是为了解决这个问题:它只跟踪顶层属性的变化,不处理嵌套对象的响应式。Vue 提供了两个 API 实现浅响应式:shallowReactive(对应 reactive)和 shallowRef(对应 ref)。

shallowReactive:只跟踪顶层属性的响应式对象

shallowReactivereactive浅版本,它仅将对象的顶层属性转换为响应式,嵌套对象不会被代理。也就是说:

  • 修改顶层属性(如 state.a)会触发更新;
  • 修改嵌套属性(如 state.b.c)不会触发更新;
  • 替换嵌套对象的引用(如 state.b = { new: 'data' })会触发更新(因为 b 是顶层属性)。

示例代码

import { shallowReactive } from 'vue'

// 创建浅响应式对象
const state = shallowReactive({
  a: 1,          // 顶层属性(响应式)
  b: { c: 2 }    // 嵌套对象(非响应式)
})

// 1. 响应式变化:修改顶层属性
state.a = 2 //  触发组件更新

// 2. 非响应式变化:修改嵌套属性
state.b.c = 3 //  不会触发更新

// 3. 响应式变化:替换嵌套对象引用
state.b = { c: 3 } //  触发更新(因为 b 是顶层属性)

shallowRef:只跟踪.value变化的浅引用

shallowRefref浅版本,它仅跟踪 ref.value替换操作,不处理 value 内部的深层响应式。也就是说:

  • 替换 ref.value(如 obj.value = { new: 'data' })会触发更新;
  • 修改 ref.value 的内部属性(如 obj.value.a = 2)不会触发更新。

示例代码

import { shallowRef } from 'vue'

// 创建浅引用
const obj = shallowRef({ a: 1 })

// 1. 响应式变化:替换.value
obj.value = { a: 2 } //  触发更新

// 2. 非响应式变化:修改.value内部属性
obj.value.a = 3 //  不会触发更新

注意:shallowRef.value 本身是非响应式的——即使你用 reactive 包裹 valueshallowRef 也不会跟踪其内部变化。

浅响应式的应用场景:性能优化与外部状态管理

浅响应式不是“替代”深层响应式,而是补充——当你需要减少响应式开销不希望Vue跟踪内部状态时使用:

场景1:处理大型对象

往期文章归档
  • Vue 3组合式API中ref与reactive的核心响应式差异及使用最佳实践是什么? - cmdragon's Blog
  • Vue 3组合式API中ref与reactive的核心响应式差异及使用最佳实践是什么? - cmdragon's Blog
  • Vue3响应式系统中,对象新增属性、数组改索引、原始值代理的问题如何解决? - cmdragon's Blog
  • Vue 3中watch侦听器的正确使用姿势你掌握了吗?深度监听、与watchEffect的差异及常见报错解析 - cmdragon's Blog
  • Vue响应式声明的API差异、底层原理与常见陷阱你都搞懂了吗 - cmdragon's Blog
  • Vue响应式声明的API差异、底层原理与常见陷阱你都搞懂了吗 - cmdragon's Blog
  • 为什么Vue 3需要ref函数?它的响应式原理与正确用法是什么? - cmdragon's Blog
  • Vue 3中reactive函数如何通过Proxy实现响应式?使用时要避开哪些误区? - cmdragon's Blog
  • Vue3响应式系统的底层原理与实践要点你真的懂吗? - cmdragon's Blog
  • Vue 3模板如何通过编译三阶段实现从声明式语法到高效渲染的跨越 - cmdragon's Blog
  • 快速入门Vue模板引用:从收DOM“快递”到调子组件方法,你玩明白了吗? - cmdragon's Blog
  • 快速入门Vue模板里的JS表达式有啥不能碰?计算属性为啥比方法更能打? - cmdragon's Blog
  • 快速入门Vue的v-model表单绑定:语法糖、动态值、修饰符的小技巧你都掌握了吗? - cmdragon's Blog
  • 快速入门Vue3事件处理的挑战题:v-on、修饰符、自定义事件你能通关吗? - cmdragon's Blog
  • 快速入门Vue3的v-指令:数据和DOM的“翻译官”到底有多少本事? - cmdragon's Blog
  • 快速入门Vue3,插值、动态绑定和避坑技巧你都搞懂了吗? - cmdragon's Blog
  • 想让PostgreSQL快到飞起?先找健康密码还是先换引擎? - cmdragon's Blog
  • 想让PostgreSQL查询快到飞起?分区表、物化视图、并行查询这三招灵不灵? - cmdragon's Blog
  • 子查询总拖慢查询?把它变成连接就能解决? - cmdragon's Blog
  • PostgreSQL全表扫描慢到崩溃?建索引+改查询+更统计信息三招能破? - cmdragon's Blog
  • 复杂查询总拖后腿?PostgreSQL多列索引+覆盖索引的神仙技巧你get没? - cmdragon's Blog
  • 只给表子集建索引?用函数结果建索引?PostgreSQL这俩操作凭啥能省空间又加速? - cmdragon's Blog
  • B-tree索引像字典查词一样工作?那哪些数据库查询它能加速,哪些不能? - cmdragon's Blog
  • 想抓PostgreSQL里的慢SQL?pg_stat_statements基础黑匣子和pg_stat_monitor时间窗,谁能帮你更准揪出性能小偷? - cmdragon's Blog
  • PostgreSQL的“时光机”MVCC和锁机制是怎么搞定高并发的? - cmdragon's Blog
  • PostgreSQL性能暴涨的关键?内存IO并发参数居然要这么设置? - cmdragon's Blog
  • 大表查询慢到翻遍整个书架?PostgreSQL分区表教你怎么“分类”才高效
  • PostgreSQL 查询慢?是不是忘了优化 GROUP BY、ORDER BY 和窗口函数? - cmdragon's Blog
  • PostgreSQL里的子查询和CTE居然在性能上“掐架”?到底该站哪边? - cmdragon's Blog
  • PostgreSQL选Join策略有啥小九九?Nested Loop/Merge/Hash谁是它的菜? - cmdragon's Blog
  • PostgreSQL新手SQL总翻车?这7个性能陷阱你踩过没? - cmdragon's Blog
  • PostgreSQL索引选B-Tree还是GiST?“瑞士军刀”和“多面手”的差别你居然还不知道? - cmdragon's Blog
  • 想知道数据库怎么给查询“算成本选路线”?EXPLAIN能帮你看明白? - cmdragon's Blog
  • PostgreSQL处理SQL居然像做蛋糕?解析到执行的4步里藏着多少查询优化的小心机? - cmdragon's Blog
  • PostgreSQL备份不是复制文件?物理vs逻辑咋选?误删还能精准恢复到1分钟前? - cmdragon's Blog
  • 转账不翻车、并发不干扰,PostgreSQL的ACID特性到底有啥魔法? - cmdragon's Blog
  • 银行转账不白扣钱、电商下单不超卖,PostgreSQL事务的诀窍是啥? - cmdragon's Blog
  • PostgreSQL里的PL/pgSQL到底是啥?能让SQL从“说目标”变“讲步骤”? - cmdragon's Blog
  • PostgreSQL视图不存数据?那它怎么简化查询还能递归生成序列和控制权限? - cmdragon's Blog
  • PostgreSQL索引这么玩,才能让你的查询真的“飞”起来? - cmdragon's Blog
  • PostgreSQL的表关系和约束,咋帮你搞定用户订单不混乱、学生选课不重复? - cmdragon's Blog
  • PostgreSQL查询的筛子、排序、聚合、分组?你会用它们搞定数据吗? - cmdragon's Blog
  • PostgreSQL数据类型怎么选才高效不踩坑? - cmdragon's Blog
  • 想解锁PostgreSQL查询从基础到进阶的核心知识点?你都get了吗? - cmdragon's Blog
  • PostgreSQL DELETE居然有这些操作?返回数据、连表删你试过没? - cmdragon's Blog
  • PostgreSQL UPDATE语句怎么玩?从改邮箱到批量更新的避坑技巧你都会吗? - cmdragon's Blog
  • PostgreSQL插入数据还在逐条敲?批量、冲突处理、返回自增ID的技巧你会吗? - cmdragon's Blog
  • PostgreSQL的“仓库-房间-货架”游戏,你能建出电商数据库和表吗? - cmdragon's Blog
  • PostgreSQL 17安装总翻车?Windows/macOS/Linux避坑指南帮你搞定? - cmdragon's Blog
  • 能当关系型数据库还能玩对象特性,能拆复杂查询还能自动管库存,PostgreSQL凭什么这么香? - cmdragon's Blog
  • 给接口加新字段又不搞崩老客户端?FastAPI的多版本API靠哪三招实现? - cmdragon's Blog
  • 流量突增要搞崩FastAPI?熔断测试是怎么防系统雪崩的? - cmdragon's Blog
  • FastAPI秒杀库存总变负数?Redis分布式锁能帮你守住底线吗 - cmdragon's Blog
  • FastAPI的CI流水线怎么自动测端点,还能让Allure报告美到犯规? - cmdragon's Blog
  • 如何用GitHub Actions为FastAPI项目打造自动化测试流水线? - cmdragon's Blog
  • 如何用Git Hook和CI流水线为FastAPI项目保驾护航? - cmdragon's Blog
  • FastAPI如何用契约测试确保API的「菜单」与「菜品」一致?
  • 为什么TDD能让你的FastAPI开发飞起来? - cmdragon's Blog
  • 如何用FastAPI玩转多模块测试与异步任务,让代码不再“闹脾气”? - cmdragon's Blog
免费好用的热门在线工具
  • RAID 计算器 - 应用商店 | By cmdragon
  • 在线PS - 应用商店 | By cmdragon
  • Mermaid 在线编辑器 - 应用商店 | By cmdragon
  • 数学求解计算器 - 应用商店 | By cmdragon
  • 智能提词器 - 应用商店 | By cmdragon
  • 魔法简历 - 应用商店 | By cmdragon
  • Image Puzzle Tool - 图片拼图工具 | By cmdragon
  • 字幕下载工具 - 应用商店 | By cmdragon
  • 歌词生成工具 - 应用商店 | By cmdragon
  • 网盘资源聚合搜索 - 应用商店 | By cmdragon
  • ASCII字符画生成器 - 应用商店 | By cmdragon
  • JSON Web Tokens 工具 - 应用商店 | By cmdragon
  • Bcrypt 密码工具 - 应用商店 | By cmdragon
  • GIF 合成器 - 应用商店 | By cmdragon
  • GIF 分解器 - 应用商店 | By cmdragon
  • 文本隐写术 - 应用商店 | By cmdragon
  • CMDragon 在线工具 - 高级AI工具箱与开发者套件 | 免费好用的在线工具
  • 应用商店 - 发现1000+提升效率与开发的AI工具和实用程序 | 免费好用的在线工具
  • CMDragon 更新日志 - 最新更新、功能与改进 | 免费好用的在线工具
  • 支持我们 - 成为赞助者 | 免费好用的在线工具
  • AI文本生成图像 - 应用商店 | 免费好用的在线工具
  • 临时邮箱 - 应用商店 | 免费好用的在线工具
  • 二维码解析器 - 应用商店 | 免费好用的在线工具
  • 文本转思维导图 - 应用商店 | 免费好用的在线工具
  • 正则表达式可视化工具 - 应用商店 | 免费好用的在线工具
  • 文件隐写工具 - 应用商店 | 免费好用的在线工具
  • IPTV 频道探索器 - 应用商店 | 免费好用的在线工具
  • 快传 - 应用商店 | 免费好用的在线工具
  • 随机抽奖工具 - 应用商店 | 免费好用的在线工具
  • 动漫场景查找器 - 应用商店 | 免费好用的在线工具
  • 时间工具箱 - 应用商店 | 免费好用的在线工具
  • 网速测试 - 应用商店 | 免费好用的在线工具
  • AI 智能抠图工具 - 应用商店 | 免费好用的在线工具
  • 背景替换工具 - 应用商店 | 免费好用的在线工具
  • 艺术二维码生成器 - 应用商店 | 免费好用的在线工具
  • Open Graph 元标签生成器 - 应用商店 | 免费好用的在线工具
  • 图像对比工具 - 应用商店 | 免费好用的在线工具
  • 图片压缩专业版 - 应用商店 | 免费好用的在线工具
  • 密码生成器 - 应用商店 | 免费好用的在线工具
  • SVG优化器 - 应用商店 | 免费好用的在线工具
  • 调色板生成器 - 应用商店 | 免费好用的在线工具
  • 在线节拍器 - 应用商店 | 免费好用的在线工具
  • IP归属地查询 - 应用商店 | 免费好用的在线工具
  • CSS网格布局生成器 - 应用商店 | 免费好用的在线工具
  • 邮箱验证工具 - 应用商店 | 免费好用的在线工具
  • 书法练习字帖 - 应用商店 | 免费好用的在线工具
  • 金融计算器套件 - 应用商店 | 免费好用的在线工具
  • 中国亲戚关系计算器 - 应用商店 | 免费好用的在线工具
  • Protocol Buffer 工具箱 - 应用商店 | 免费好用的在线工具
  • IP归属地查询 - 应用商店 | 免费好用的在线工具
  • 图片无损放大 - 应用商店 | 免费好用的在线工具
  • 文本比较工具 - 应用商店 | 免费好用的在线工具
  • IP批量查询工具 - 应用商店 | 免费好用的在线工具
  • 域名查询工具 - 应用商店 | 免费好用的在线工具
  • DNS工具箱 - 应用商店 | 免费好用的在线工具
  • 网站图标生成器 - 应用商店 | 免费好用的在线工具
  • XML Sitemap

如果你的对象包含大量数据(比如表格的 thousands 条记录),但只需要跟踪顶层状态(如 isLoadingcurrentPage),用 shallowReactive 可以避免递归代理所有嵌套属性:

const tableState = shallowReactive({
  isLoading: true,
  currentPage: 1,
  data: [] // 大数组,内部变化无需Vue跟踪
})

场景2:外部管理的状态

如果对象的内部状态由外部库管理(比如 axios 的响应对象、Redux 的 store、第三方组件的状态),Vue 不需要跟踪其内部变化,用浅响应式更合适:

import { shallowRef } from 'vue'
import axios from 'axios'

// 用shallowRef包裹axios响应,只跟踪.value的替换
const response = shallowRef(null)

const fetchData = async () => {
  const res = await axios.get('/api/data')
  response.value = res.data //  触发更新(替换.value)
}

实践示例:用shallowReactive管理外部API状态

假设你有一个用户详情页,需要:

  • 跟踪 isLoading(加载状态,顶层属性);
  • 展示用户数据(由API返回,内部变化无需Vue跟踪)。

完整组件代码

<script setup>
import { shallowReactive } from 'vue'

// 浅响应式状态:只跟踪顶层属性
const userState = shallowReactive({
  isLoading: true,
  userData: null // 由API填充,内部变化不触发Vue更新
})

// 模拟API请求
const fetchUser = async () => {
  userState.isLoading = true
  // 假设userData由外部API返回,内部状态无需Vue跟踪
  const res = await fetch('/api/user/1')
  const data = await res.json()
  userState.userData = data //  触发更新(替换顶层属性userData)
  userState.isLoading = false //  触发更新(修改顶层属性isLoading)
}

// 初始化加载
fetchUser()
</script>

<template>
  <div class="user-page">
    <!-- 加载状态(响应式) -->
    <div v-if="userState.isLoading" class="loading">加载中...</div>
    
    <!-- 用户数据(非响应式内部变化) -->
    <div v-else class="user-details">
      <h2>{{ userState.userData.name }}</h2>
      <p>年龄:{{ userState.userData.age }}</p>
      <p>邮箱:{{ userState.userData.email }}</p>
    </div>
  </div>
</template>

效果说明

  • isLoadinguserData 变化时(都是顶层属性),组件会更新;
  • 如果 userData 内部的 name 变化(比如 userState.userData.name = 'Bob'),组件不会更新——因为这是嵌套属性,浅响应式不跟踪。

课后Quiz:巩固浅响应式知识

问题1(多选)

以下关于 shallowReactive 的描述,正确的是?
A. shallowReactive 会使对象的所有属性(包括嵌套)响应式
B. shallowReactive 只使对象的顶层属性响应式
C. 修改 shallowReactive 对象的嵌套属性会触发更新
D. 替换 shallowReactive 对象的嵌套对象引用会触发更新

答案:B、D
解析shallowReactive 仅处理顶层属性,所以 B 正确;替换嵌套对象的引用(如 state.b = { new: 'data' })是顶层属性的变化,会触发更新,所以 D 正确。

问题2(单选)

当使用 shallowRef 时,以下哪种操作会触发组件更新?
A. 修改 ref.value 的内部属性(如 obj.value.a = 2
B. 替换 ref.value(如 obj.value = { a: 2 }
C. 修改 ref 的非 .value 属性(如 obj.a = 2
D. 以上都不会

答案:B
解析shallowRef 只跟踪 .value 的替换操作,所以 B 正确;A 是内部属性变化,不会触发;C 是错误操作(ref 没有 a 属性,只有 .value)。

常见报错与解决方案

报错场景1:修改shallowRef内部属性不触发更新

错误代码

<script setup>
import { shallowRef } from 'vue'

const user = shallowRef({ name: 'Alice' })

// 修改内部属性,但页面不更新
const changeName = () => {
  user.value.name = 'Bob'
}
</script>

<template>
  <p>{{ user.value.name }}</p>
  <button @click="changeName">改名</button>
</template>

原因shallowRef 不跟踪 .value 内部的变化。
解决方案

  1. 改用 ref(需要深层响应式时):
    import { ref } from 'vue'
    const user = ref({ name: 'Alice' })
    
  2. 手动触发更新(用 triggerRef):
    import { shallowRef, triggerRef } from 'vue'
    const user = shallowRef({ name: 'Alice' })
    
    const changeName = () => {
      user.value.name = 'Bob'
      triggerRef(user) //  手动触发更新
    }
    

报错场景2:修改shallowReactive嵌套属性不触发更新

错误代码

<script setup>
import { shallowReactive } from 'vue'

const state = shallowReactive({
  user: { name: 'Alice' }
})

// 修改嵌套属性,页面不更新
const changeName = () => {
  state.user.name = 'Bob'
}
</script>

<template>
  <p>{{ state.user.name }}</p>
  <button @click="changeName">改名</button>
</template>

原因shallowReactive 不处理嵌套对象的响应式。
解决方案

  1. 改用 reactive(需要深层响应式时):
    import { reactive } from 'vue'
    const state = reactive({ user: { name: 'Alice' } })
    
  2. 替换嵌套对象引用(触发顶层属性变化):
    const changeName = () => {
      state.user = { ...state.user, name: 'Bob' } //  替换引用,触发更新
    }
    

参考链接

  • Vue 官方文档:Shallow Reactivity
本站提供的所有下载资源均来自互联网,仅提供学习交流使用,版权归原作者所有。如需商业使用,请联系原作者获得授权。 如您发现有涉嫌侵权的内容,请联系我们 邮箱:[email protected]