1 / 4概念
State and Data
Vue 的响应式是运行时的代理加编译期的标记。判断标准不是会不会写 ref,而是能否说清一个属性被读时谁记下了依赖,被写时谁被通知,以及为什么同一个 tick 里的三次修改只渲染一次。
1 概念
1.1 一句话定义
用 Proxy 包住对象,读属性时把当前副作用记成依赖,写属性时通知这些副作用重新执行。组件渲染本身就是一个副作用,所以状态一变,界面就重算。
1.2 它解决什么问题
- 自动追踪:不需要手写依赖数组,读了什么就依赖什么。
- 精确更新:只有读到被改属性的副作用才重新执行。
- 模板效率:模板编译成渲染函数,并做静态提升与标记,减少运行时比较。
- 单文件组件:模板、逻辑、样式写在一个文件里,编译期各自处理。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| 路由、状态库、服务端渲染框架 | Application Architecture |
| React 的渲染与状态模型 | Rendering and Reconciliation、State and Data |
| 浏览器 DOM 与事件 | Browser Environment |
| 打包与产物体积 | Toolchain |
| 对象与 Proxy 的语言细节 | Objects and Prototypes |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
ref | 带 .value 的响应式容器 | 模板里自动解包 |
reactive | 深层代理的对象 | 整体替换会丢代理 |
| 副作用 | 被追踪的函数 | 渲染函数就是一个 |
| 依赖收集 | 读属性时记录副作用 | 只记录读过的属性 |
| 触发 | 写属性时通知依赖 | 走调度器而非直接执行 |
computed | 惰性求值且带缓存 | 不是 watch |
watchEffect | 自动收集依赖的侦听 | 与 watch 时机不同 |
| 静态提升 | 编译期把不变节点移出渲染 | 减少创建开销 |
patchFlag | 编译期标记动态部分 | 运行时按位判断 |
| SFC | 单文件组件 | 不是运行时概念 |
| 解包 | 模板中自动访问 .value | 脚本里必须显式写 |
2 机制
2.1 心智模型
三个角色:副作用、依赖表、代理。副作用执行时读到属性,代理把它记到该属性的依赖集合;属性被写时,代理取出集合交给调度器,调度器在微任务里批量执行。渲染函数只是最特殊的一个副作用。
2.2 机制拆解
ref与reactive:ref用一个带value的对象包装,任何类型都能装;reactive返回代理,只对对象有效。- 深层与浅层:默认递归代理,
shallowRef与shallowReactive只处理第一层,适合大对象。 - 解构陷阱:从
reactive解构出来的属性是普通值,失去追踪;要用toRefs或直接访问对象属性。 computed:惰性求值,缓存结果,依赖变化时标记失效,下次读取再重算。watch与watchEffect:前者显式给源,后者自动收集;默认在组件更新前执行。- 批量更新:同一微任务内的多次修改只触发一次调度,
nextTick在刷新之后执行。 - 编译优化:静态节点提升为常量,动态节点打
patchFlag,事件处理函数缓存,块树让运行时只比较动态部分。
2.3 完整枚举
响应式 API,这是完整集合:
| API | 作用 |
|---|---|
ref | 任意值的响应式容器 |
shallowRef | 只追踪 .value 的替换 |
reactive | 对象的深层代理 |
shallowReactive | 只代理第一层 |
readonly | 只读代理 |
shallowReadonly | 只读的第一层代理 |
computed | 缓存的计算值 |
watch | 侦听指定源 |
watchEffect | 自动收集依赖的侦听 |
toRef | 把属性转成单个 ref |
toRefs | 把对象所有属性转成 ref |
triggerRef | 手动触发浅层 ref |
markRaw | 标记对象永不代理 |
effectScope | 批量管理副作用的生命周期 |
watch 的三种刷新时机:
flush | 执行时机 | 适用 |
|---|---|---|
'pre' | 组件更新前,默认 | 读取旧 DOM、准备数据 |
'post' | 组件更新后 | 需要最新 DOM |
'sync' | 同步立即执行 | 极少使用,易多次触发 |
模板编译的四项优化:
| 优化 | 作用 |
|---|---|
| 静态提升 | 不变节点移出渲染函数 |
patchFlag | 标记动态属性与文本 |
| 事件缓存 | 避免每次渲染新建函数 |
| 块树 | 跳过静态子树的比较 |
SFC 的三个块与产物:
| 块 | 编译结果 |
|---|---|
template | 渲染函数,带优化标记 |
script setup | 组件选项,顶层绑定暴露给模板 |
style scoped | 带作用域属性的样式 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| 批量更新窗口 | 一个微任务 | 同一 tick 只渲染一次 |
nextTick 时机 | 刷新之后 | 拿到更新后的 DOM |
| 依赖收集粒度 | 单个属性 | 不是整个对象 |
| 浅层代理开销 | 与第一层属性数相关 | 大数组建议 shallowRef |
| 组件重渲染范围 | 读取了变化属性的组件 | 父更新不一定子更新 |
3 实践
3.1 最小示例
解构会丢响应式,toRefs 能保住。computed 的缓存也在同一段里体现。
import {computed, reactive, toRefs, watchEffect} from 'vue';
const state = reactive({first: 'Ada', last: 'Lovelace'});
// 丢响应式:解构出普通字符串,之后 state.first 变化不会影响 full
const {first} = state;
const full = computed(() => `${state.first} ${state.last}`);
watchEffect(() => {
console.log('render', full.value);
});
// 输出 render Ada Lovelace
state.first = 'Grace';
// 输出 render Grace Lovelace,computed 重算,watchEffect 重新执行
console.log(first); // 仍是 'Ada',没有追踪
追踪:computed 首次读 state.first 与 state.last,两个属性都记下这个计算副作用。写 state.first 触发依赖,调度器在微任务里让 full 失效并执行 watchEffect。first 是普通字符串,与代理没有任何关系,所以永远停在旧值。
修法:const {first} = toRefs(state),之后用 first.value 读取。
3.2 常用操作与参数
| 操作 | 写法 | 说明 |
|---|---|---|
| 基本容器 | const count = ref(0) | 脚本里用 .value |
| 对象代理 | const form = reactive({...}) | 不要整体替换 |
| 解构保留 | const {name} = toRefs(form) | 或用 storeToRefs |
| 缓存派生 | computed(() => a.value + b.value) | 不要在里面写副作用 |
| 侦听字段 | watch(() => form.id, fn) | 源是 getter |
| 侦听对象 | watch(obj, fn, {deep: true}) | 深层遍历有成本 |
| 立即执行 | {immediate: true} | 首次也调用 |
| 等 DOM | await nextTick() | 更新后读取 |
| 只追踪替换 | shallowRef(bigArray) | 配 triggerRef 手动触发 |
3.3 标准流程
- 先定状态形状:对象用
reactive,单值用ref。 - 派生值一律用
computed,不要用watch写回状态。 - 需要副作用才用
watch,并明确flush时机。 - 大数组或第三方实例用浅层 API 加
markRaw。 - 跨组件共享状态放状态库,不靠
provide传可变对象。 - 用开发工具看依赖与重渲染,不要凭感觉加缓存。
3.4 与相邻技术的组合
- 对象与 Proxy:响应式依赖
Proxy的get与set,Object.freeze的对象不会被追踪。 - 模板:模板里的
ref自动解包,脚本里必须写.value。 - 路由与状态库:
Pinia的 store 本身就是响应式对象,storeToRefs保留解构后的响应性。 - 服务端渲染:服务端没有 DOM,响应式照常运行,水合时状态要能重建。
- 类型系统:
ref<T>()显式标注泛型,computed的返回类型由返回值推断。
3.5 选型维度
| 维度 | 取值 | 影响 |
|---|---|---|
| 容器 | ref / reactive / 浅层 | 解包方式与开销 |
| 派生 | computed / 函数 / watch | 缓存与副作用 |
| 侦听时机 | pre / post / sync | DOM 是否已更新 |
| 组件写法 | SFC / JSX / 渲染函数 | 编译优化程度 |
| 状态归属 | 组件 / provide / store | 复用与测试 |
3.6 决策规则
- 单值用
ref,成组字段用reactive,需要传递时用toRefs。 - 能从状态算出来的值用
computed,不要用watch回写。 - 只有需要副作用(请求、日志、DOM)时才用
watch。 - 大对象用
shallowRef,改完调用triggerRef。 - 需要在 DOM 更新后测量时用
flush: 'post'或nextTick。 - 组件间共享用状态库,
provide只传稳定的依赖。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
ref | 任意类型、显式 | 需要 .value | 单值 |
reactive | 访问自然 | 解构丢响应式 | 表单对象 |
computed | 缓存、可组合 | 不能有副作用 | 派生值 |
watch | 精确控制时机 | 需要手写源 | 副作用 |
watchEffect | 自动收集 | 依赖不直观 | 原型阶段 |
| 状态库 | 跨组件、可调试 | 多一层依赖 | 中大型应用 |
3.8 何时不该用
- 不要在
computed里发请求或改其他状态。 - 不要对超大数组做深层
reactive。 - 不要用
watch复制一个computed能表达的关系。 - 不要在模板里写复杂表达式,抽成
computed。 - 不要整体替换
reactive对象,引用会换成普通对象。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
| 改了对象界面不动 | 解构丢了响应式 | toRefs 或直接访问 |
| 整体替换后失去响应 | reactive 被赋了新对象 | 逐字段赋值或改用 ref |
| 深层修改没触发 | 用了浅层 API | triggerRef 或换深层 |
| 侦听对象不触发 | 属性变了但引用没变且没开 deep | 开 deep 或侦听具体字段 |
| 渲染后才拿到旧 DOM | 在更新前读取 | await nextTick() |
| 无限循环 | 侦听里改被侦听的值 | 拆分依赖或加条件 |
| 第三方实例被代理后出错 | 深层代理改写了内部行为 | markRaw |
| 服务端与客户端首帧不同 | 水合时状态不一致 | 状态可重建 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
computed 里写状态 | 循环依赖 | 副作用放 watch |
watch 回写状态 | 两条更新链 | computed |
| 大数组深层代理 | 首次访问变慢 | shallowRef |
| 模板里直接改状态 | 难追踪 | 事件处理函数 |
用 ref 包整个 store | 双重包装 | 直接使用 store |
4.3 可观测信号
组件重渲染次数、依赖数量、nextTick 队列长度、侦听器触发次数、浅层 API 的使用比例、开发工具里的更新时间线。
4.4 安全 / 性能 / 一致性边界
- 代理边界:深层代理会拦截所有属性访问,第三方对象(地图、图表、编辑器实例)被代理后可能出错。
- 性能边界:依赖收集成本与读取属性次数成正比,渲染函数里避免重复深读。
- 一致性边界:同一 tick 内的多次修改只触发一次渲染,依赖中间态的代码必须改用
watch的sync或nextTick。 - 水合边界:服务端渲染时状态由数据重建,不能依赖浏览器 API 生成初始值。