patchflags 是 vue 3 编译器为动态 vnode 打的位掩码,用于精准标识可变字段:text(1)仅更新文本,class(2)/style(4)专属性更新,props(8)/full_props(16)按需比对属性,hoisted(-1)标记静态提升节点,bail(-2)触发全量 diff。

PatchFlags 是 Vue 3 编译器在模板编译阶段,为每个动态 VNode 打上的位掩码整数,它的核心作用不是“分类”,而是告诉运行时:**这个节点哪些字段可能变、哪些绝对不变**。识别不是靠运行时猜测,而是在 AST 构建时就完成的静态语义判定——编译器一眼看穿模板结构,把更新意图提前固化。
TEXT(值为 1):只动文字,不动结构
当一个元素子节点仅为响应式插值(如 {{ msg }}),且不含组件、插槽或 HTML 标签时,编译器判定它只影响文本内容。此时 patch 过程跳过所有 props 和子节点比对,直接执行 el.textContent = next.children。若插值混入静态文本(如 Hello {{ name }}),编译器会拆解并仅对动态片段打 TEXT 标记,静态部分则被提升复用。
CLASS(值为 2)与 STYLE(值为 4):专属性更新,不碰其他
绑定:class 或 :style 时,编译器提取表达式内容(如 { active: isActive } 或 { color: c, fontSize: s }),确认其结果类型是对象/数组后,标记 CLASS 或 STYLE。运行时调用专用 patch 函数(patchClass / patchStyle),只操作 className 或 style 属性,完全绕过 attrs 遍历、事件比对、子节点 diff。字符串拼接写法(如 :class="'base ' + cls")也会触发 CLASS,但可能生成更复杂的 class 合并逻辑。
PROPS(值为 8)与 FULL_PROPS(值为 16):按需更新属性,而非全量遍历
遇到 :id、:data-id、:aria-label 等非 class/style 的响应式属性时,编译器标记 PROPS,并在生成代码中附带 dynamicProps 数组(如 ['id', 'disabled'])。运行时只比对这些明确列出的属性,跳过 class、style、事件监听器等无关字段。若该节点还包含 v-if/v-for/插槽,则升级为 FULL_PROPS——这意味着 props 结构本身可能变化(比如 key 动态切换导致属性集合不同),必须走更保守的完整 props 对比路径。
HOISTED(值为 -1)与 BAIL(值为 -2):两类特殊决策信号
HOISTED 不是“动态类型”,而是静态提升的结果标记:该节点完全无响应式依赖,编译期已抽成常量,运行时直接复用引用,连是否更新都不判断。BAIL 则是编译器的“放弃优化”信号,出现在含复杂表达式(如函数调用、this 引用、副作用运算)的绑定中,此时无法安全推断变更范围,退回到 Vue 2 式全量 diff,确保行为正确性优先。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











