# Assert 使用策略

## 范围
- 仅用于不可恢复的内部不变量破坏。
- 不用于用户可构造输入导致的常规错误。
- 术语口径见 `../../shared/terminology.md`。

## 判定规则
- 输入错误可恢复：返回 false/NULL，并保证资源回收。
- 内存破坏或结构破坏不可恢复：允许 assert（启用 `RyanJsonEnableAssert` 时）。
- Compare 内部对象链/Key 不变量属于结构破坏范畴，可按 assert 路径处理，不要求业务输入可达覆盖。

## 测试策略
- 单元测试验证“可恢复错误”返回路径。
- fuzzer 避免把业务预期写成 assert。
- 对 assert 路径，重点确认是否误分类。

## 常见误用
- 用 assert 拦截重复 key、非法数字、非法字符串输入。
- 以 assert 代替失败路径释放逻辑。

## 依据（仓库内）
- `RyanJson/RyanJson.h`：断言宏与公开语义注释
- `RyanJson/RyanJsonItem.c`：失败路径与可恢复错误返回
- `test/unityTest/cases/core/testCreate.c`、`test/unityTest/cases/core/testReplace.c`