一句话答案
处理运行时校验需要支持的浏览器/软件、足够的磁盘/内存,以及正确的输入文件。 TS 类型编译后消失,外部 JSON 仍需运行时校验。
为什么重要
缺少任一条件都可能把环境问题误判成文件损坏。
Zod/Valibot/io-ts 可用。
具体怎么做
- 先贴真实/完整的 JSON 示例,覆盖可选字段和空数组。
- 生成后检查数组元素、null/可选、嵌套对象。
- 设置根类型名,复制到项目。
- 正式项目补 Zod/Valibot 运行时校验。
- 为 API 变更加契约测试/版本。
常见错误
- 把示例当完整 schema,漏可选/空数组。
- 直接相信生成的 any/null 联合。
- 属性名含空格/中文忘了引号。
- 生成后不做运行时校验。
检查清单
- JSON 示例覆盖可选/空数组/null。
- 数组对象字段已合并。
- 属性名/根名合法。
- 已补运行时校验。
- API 契约/版本已考虑。
关键事实
- Zod/Valibot/io-ts 可用。
- 入口处校验一次。
常见问题
处理运行时校验需要什么?
处理运行时校验需要支持的浏览器/软件、足够的磁盘/内存,以及正确的输入文件。 TS 类型编译后消失,外部 JSON 仍需运行时校验。
检测要多久?
通常 1–3 分钟;如果问题间歇出现,连续测 30 秒并换环境复测。
会上传数据吗?
本页在浏览器本地运行,不上传画面/声音;扩展仍可能读取页面。
来源: Zod