深入 PatchFlags.SHAPE_FLAG 的结构

秋涛同学_7460

秋涛同学_7460

2026-06-24

360人浏览

原创

shapeflags 和 patchflags 是 vue 3 中两个正交的位标志系统:前者标识 vnode 静态结构类型(如 element=1、stateful_component=4),后者标记动态更新字段(如 text=1、class=2);二者定义分离、比特位不重叠,不可混用。

深入 patchflags.shape_flag 的结构

“PatchFlags.SHAPE_FLAG”这个写法本身并不存在——这是常见的概念混淆。Vue 3 中没有 PatchFlags.SHAPE_FLAG 这个枚举项,ShapeFlags 和 PatchFlags 是两个完全独立、职责分明的位标志系统,分别定义在不同模块中,不能混用或嵌套引用。

ShapeFlags 是什么?静态身份标识

ShapeFlags 描述的是 VNode 的结构本质:它是什么类型的节点、子节点以何种形式组织、是否具备容器语义等。这些信息在 VNode 创建时就确定,整个生命周期不变。

  • ELEMENT(值为 1):普通 HTML 元素,如 <div> <li>STATEFUL_COMPONENT(值为 4):有状态组件(含 setup / data / 生命周期)</li> <li>FUNCTIONAL_COMPONENT(值为 2):纯函数式组件</li> <li>TEXT_CHILDREN(值为 8):children 是字符串</li> <li>ARRAY_CHILDREN(值为 16):children 是 VNode 数组</li> <li>FRAGMENT / TELEPORT / SUSPENSE(各占一个独立比特位):高阶容器节点</li> <p>它们通过位或(<code>|)组合。例如一个返回数组的有状态组件,其 shapeFlag = STATEFUL_COMPONENT | ARRAY_CHILDREN = 4 | 16 = 20(二进制 00010100)。

    免费语音克隆
    免费语音克隆

    一款提供AI语音克隆和文本转语音能力的在线工具,可根据声音样本生成具有相似音色特征的语音内容。

    下载

    PatchFlags 是什么?动态更新线索

    PatchFlags 描述的是 VNode 中哪些部分绑定了动态值,由模板编译器在编译阶段生成,用于运行时跳过静态内容、只更新真正变化的字段。

    • TEXT(1):textContent 动态绑定(如 {{ msg }})
    • CLASS(2):class 属性动态绑定
    • STYLE(4):style 属性动态绑定
    • PROPS(8):除 class/style 外的其他 props 动态绑定
    • FULL_PROPS(16):props 完全动态(如 v-bind="obj")
    • KEYED_FRAGMENT(128):带 key 的多根节点片段

    比如 <div :class="cls" :style="sty">{{ text }},它的 <code>patchFlag = CLASS | STYLE | TEXT = 2 | 4 | 1 = 7,patch 阶段就只比对这三项,其余属性直接复用。

    为什么二者不能混用?分工不可替代

    ShapeFlags 解决“这是什么”,PatchFlags 解决“哪里要改”。它们作用于渲染流程的不同阶段:

    • createVNode 阶段:根据节点类型(如组件、元素)计算并设置 shapeFlag;同时编译器注入 patchFlag
    • patch 阶段:先用 shapeFlag & ELEMENT 快速分发到 processElement;进入后,再用 patchFlag & TEXT 判断是否需更新文本
    • 若强行把 ShapeFlags 当 PatchFlags 用(如 patchFlag & STATEFUL_COMPONENT),结果恒为 0——因为它们的比特位不重叠,逻辑上无意义

    怎么查真实定义?看源码位置

    两者都定义在 @vue/shared 包中,但文件分离清晰:

    • packages/shared/src/shapeFlags.ts:导出 enum ShapeFlags,含 ELEMENT、COMPONENT 等
    • packages/shared/src/patchFlags.ts:导出 enum PatchFlags,含 TEXT、CLASS、DYNAMIC_SLOTS 等
    • 它们互不 import,也不共享常量名,是两套正交的位域设计

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

vue 3

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
vue2.0和3.0区别
vue2.0和3.0区别

vue2.0和3.0区别:vue2的响应式原理是利⽤“Object.defineProperty()”对数据进⾏劫持结合发布订阅模式的⽅式来实现,vue3中使⽤了es6的proxy API对数据代理,实现对数据的监控。本专题为大家提供vue2.0和3.0区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.17

1634

5

vue3的生命周期有哪些
vue3的生命周期有哪些

vue3的生命周期:1、beforecreate;2、created;3、beforemount;4、mounted;5、beforeupdate;6、updated;7、beforedestroy;8、destroyed;9、activated;10、deactivated等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

11802

5

Vue3组合式API与组件开发实战
Vue3组合式API与组件开发实战

本专题讲解 Vue 3 组合式 API 的核心概念与应用技巧,深入分析响应式系统、生命周期管理、组件设计与复用策略。通过完整项目案例,指导前端开发者实现高性能、结构清晰的 Vue 应用,提升开发效率与代码可维护性。

2026.02.10

296

23

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

2026.09.30

20

10

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

2026.09.30

0

14

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

2026.09.30

0

12

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

2026.09.30

20

26

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

2026.09.29

20

15

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

2026.09.23

220

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.6万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.4万人学习