高效流式JSON解析器采用字符流+状态机驱动，按需递进解析，用轻量栈管理层级，支持异构字段延迟绑定、零拷贝字符串、数字区段记录及精准错误定位（含行列号与路径），提供Push/Pull两种流式接口。
直接手写一个能高效流式解析异构多级 json 的解析器，不依赖第三方库，核心不在“炫技”，而在“可控”——结构清晰、错误定位准、内存占用低、对非法输入有明确反馈。关键不是堆嵌套循环，而是用状态机驱动分支 + 按需递进解析，配合轻量栈管理层级。
用字符流+状态机替代深度递归
JSON 层级再深，也不该靠函数递归（易栈溢出）或无限 for 嵌套（难维护）。应把输入视为字节/字符流，逐个读取，用有限状态（如：等待键、读字符串值、进入对象、进入数组、跳过空白）切换行为。每个状态只关心当前字符含义，不预设下几层结构。
- 遇到
{→ 推入新对象上下文，状态切为“等待键” - 遇到
"→ 进入字符串扫描，直到下一个未转义的" - 遇到
:→ 确认上一个 token 是合法 key，切换为“等待值” - 遇到
,→ 根据当前上下文判断是否允许（如对象中非首项、数组中非首项） - 遇到
}或]→ 弹出栈顶上下文，校验闭合合法性
异构字段靠类型探测+延迟绑定
同一数组里可能混着对象、数字、null、字符串——不要一上来就分配 map 或 list。先识别 token 类型（通过首字符快速分流："→字符串，{→对象，[→数组，n→null，t→true，f→false，数字字符→number），再按需构造对应轻量节点（如用 union struct 或 tagged pointer）。值内容不立即 decode，只记起止偏移，真正需要时再提取（即“lazy parse”）。
- 字符串值暂存起始位置和长度，不 malloc 复制；需要时再 utf-8 解码或转义处理
- 数字先跳过前导空格和符号，记录数字区段，parse_number() 按需调用
- 嵌套结构（对象/数组）只压栈上下文，不提前分配容器，直到遇到对应结束符才初始化
错误处理必须带位置与上下文
手工解析器健壮性的分水岭，在于报错信息能否帮人 3 秒内定位问题。每个状态转移失败时，必须返回带偏移（offset）、行号（line）、列号（col）、期望字符、实际字符、当前嵌套路径（如 $.data.items[2].config）的错误结构。
- 维护一个简单行号计数器：遇到
\n就 line++，col 重置为 0 - 栈中每个上下文记录其起始 offset 和路径片段（key 名或数组索引）
- 例如：在期待
:却读到,，错误提示：“expected ':' after key at line 42, col 17 — path: $.users[0]”
流式输出靠事件回调或迭代器接口
所谓“流式”，是指不等整个 JSON 加载完才开始处理。解析器应提供两种模式：
- Push 模式：注册 on_object_start、on_string_value、on_number 等回调，每识别一个完整语义单元就触发
- Pull 模式：暴露 next_token()，返回 token 类型（STRING、NUMBER、BEGIN_OBJECT…）和关联数据（如字符串 slice、数字 double 值），由上层控制遍历节奏
- 两者都共享同一底层状态机，仅上层接口不同，避免重复逻辑
不复杂但容易忽略：真正的极速来自缓存友好（连续读字符、小栈帧）、零拷贝（view-based 字符串）、无异常抛出（用返回码代替 try/catch）、以及提前终止（如只需找某个字段，匹配后可立即 stop）。写这类解析器，重点不是“多层嵌套怎么写”，而是“状态怎么清、错误怎么报、边界怎么守”。
