normalizeVNode 的作用是将字符串、数字、null 等单个子节点归一化为标准 VNode：字符串/数字转 Text VNode，null/undefined/false 转空 VNode，已是 VNode 则直接返回；不处理数组，仅用于单节点级输入。
normalizeVNode 的作用不是处理“多种数据格式”（如 JSON/CSV/XML），而是统一 Vue 渲染流程中**子节点的 JavaScript 表示形式**——把字符串、数字、null、单个 VNode、嵌套数组等，规整成标准的、可被 patch 和 mount 正确处理的 VNode 结构。它解决的是运行时子节点类型混杂带来的渲染不一致问题，而非跨系统或文件的数据格式兼容性。
normalizeVNode 做了什么？
它是一个轻量级归一化函数，核心逻辑简单直接：
- 输入是字符串或数字 → 创建一个 Text 类型的 VNode（用
Symbol('Text')标识，不是字符串 'text'） - 输入是 null / undefined / false → 返回一个空 VNode（
createVNode(null)），不渲染任何内容 - 输入已经是 VNode 对象 → 直接返回，不做改动
- 不处理数组——那是
normalizeChildren的职责；normalizeVNode只处理单个节点级输入
什么时候需要手动调用 normalizeVNode？
绝大多数情况下你不需要手动调用它。它主要在以下场景被框架内部使用：
Blender Geometry Nodes Script Generator
下载
生成Blender Python (bpy)脚本，该脚本使用node_groups API和GeometryNodeTree接口程序化地创建几何节点修改器树，用于参数化3D资产生成。
- 手写 render 函数时，对插槽内容或动态 children 中的单项做兜底：比如
normalizeVNode(slots.default?.()[0]) - 封装自定义 h 工具函数时，确保传入的任意子项都转为合法 VNode：
h('div', {}, normalizeVNode(child)) - 开发低层级渲染器或调试 VNode 构造过程时，用于验证输入是否符合预期结构
别和 normalizeChildren 混淆
如果你面对的是数组、嵌套数组、混合字符串+VNode 等复杂 children 结构，真正该用的是 normalizeChildren：
-
normalizeVNode('hello')→ 返回一个 Text VNode -
normalizeChildren(['hello', h('span'), null, [h('i')]])→ 返回扁平后的 VNode 数组：[TextVNode, SpanVNode, IVNode] - 模板编译、
h()函数、插槽展开等，底层都自动调用了normalizeChildren
兼容性问题的真正解法
所谓“多种数据格式渲染兼容性”，实际常指两类情况：
-
用户输入不规范：比如组件接收的
message可能是 string / number / undefined，直接插值可能出错 → 应在组件内部用String(props.message)或normalizeVNode(props.message)防御性处理 - 服务端返回结构多变：比如 API 字段有时是字符串，有时是对象，有时为空 → 这属于数据预处理范畴，应在请求后、传给组件前做标准化（例如统一转成 { text: '…', type: 'info' }），而不是靠 VNode 规范化补救
