一句话答案
本地代码生成工具更私密、可离线;在线工具省安装,但文件会离开设备。 把生成器纳入构建/CI,避免类型与 API 漂移。
为什么重要
敏感文件优先本地,临时小文件可用在线。
生成文件不要手改。
具体怎么做
- 先贴真实/完整的 JSON 示例,覆盖可选字段和空数组。
- 生成后检查数组元素、null/可选、嵌套对象。
- 设置根类型名,复制到项目。
- 正式项目补 Zod/Valibot 运行时校验。
- 为 API 变更加契约测试/版本。
常见错误
- 把示例当完整 schema,漏可选/空数组。
- 直接相信生成的 any/null 联合。
- 属性名含空格/中文忘了引号。
- 生成后不做运行时校验。
检查清单
- JSON 示例覆盖可选/空数组/null。
- 数组对象字段已合并。
- 属性名/根名合法。
- 已补运行时校验。
- API 契约/版本已考虑。
关键事实
- 生成文件不要手改。
- 版本/差异要可审查。
常见问题
本地和在线工具哪个更适合代码生成?
本地代码生成工具更私密、可离线;在线工具省安装,但文件会离开设备。 把生成器纳入构建/CI,避免类型与 API 漂移。
检测要多久?
通常 1–3 分钟;如果问题间歇出现,连续测 30 秒并换环境复测。
会上传数据吗?
本页在浏览器本地运行,不上传画面/声音;扩展仍可能读取页面。