该资料是一篇面向 Kotlin 开发者的解析设计经验文档，主题是“解析失败的回退值不能与成功路径产生的值混淆”。
用途 文章关注解析器在无法解析输入时应返回什么。它指出 ?: 0、?: "" 这类回退会让同一个值同时表示“零/空”和“解析失败”，导致下游每个消费者各自猜测，且猜测方式不一致。
主要能力 文章归纳了三种诚实回退：一是成功路径永远不可能产生的哨兵值（如非负域用负数、真实测量域用 MAX_VALUE）；二是在类型中表达缺失（null 或 sealed 层级中的 Unknown）；三是不做回退，让解析失败并交由调用方决定。文章认为类型层面的缺失最不易误读，因为编译器会强制每个消费者处理。
文章还列出一组陷阱：哨兵值若落在类型合法范围内，其安全性完全依赖“有东西保证覆盖它”这一约定；一旦多个读取方各自解释，就会出现显示占位符永不刷新等问题。合法范围内的回退值（如时长解析失败返回 0）会迫使每个下游永久写 takeIf { it > 0 } 之类守卫。把未知折叠进布尔值（isVideo 对未知返回 false）会让 !isVideo(x) 被误读为“音频”，因此需要显式 isKnown。比较存储值前必须经过统一归一化，因为旧代码写入的值可能用了不同词汇。UI 颜色用主题色作为未解析占位，会在加载时闪错色调，应在消费者处把 null 解释为“不绘制”而非替换默认值。不要为满足非空字段而伪造“Unknown Artist”“0:00”等占位。本地失败码应使用远端范围之外的负数码。
使用方式 文章通过代码片段展示格式化函数对负数保留、isVideo/isAudio/isKnown 三个谓词的分工、Compose 中 Color.Unspecified 与 null 的组合，并给出多条 grep 命令用于审计代码库中的常见回退（toIntOrNull() ?: 0 等）、检查未知状态是否可达、核对颜色默认值与哨兵检查是否成对。最后建议用“字段删除”和“字段为垃圾”两种载荷验证各层能否区分。
适用场景 适用于 Kotlin 解析器、数据模型、数据库读写、UI 派生状态等需要表达“未知/缺失”的场景。
限制 资料为技术文章，未提供独立产品、安装命令或平台信息；部分代码片段注明为改编且名称泛化，非完整可运行示例。分类依据其编程语言与开发实践内容确定为“编程与开发”。