工具用的顺手吗？
你的反馈能帮助我们做得更好
将JSON数据转换为Crystal类定义，自动生成类型安全的序列化代码。
概览
了解工具能解决的问题、计算或处理逻辑，以及数据边界。
JSON是一种常见的数据交换文本格式，值可为对象、数组、字符串、数字、布尔值或null。本工具读取JSON样例并生成Crystal语言的数据类型代码，便于把外部响应或配置结构映射到程序类或结构定义。输入是有效JSON文本，输出为代码；它不会替你建立完整接口客户端，也不会推断业务校验规则。
样例只展示其中出现的字段和值。若某字段样例里只有整数，单凭这一条数据无法知道实际接口是否也可能返回小数、null或其他类型。尽可能使用覆盖常见结构的样例，尤其注意嵌套对象、数组及不同数据版本。
Crystal官方文档介绍JSON::Serializable可为Crystal类型提供JSON序列化和反序列化支持。生成结果可作代码起点，是否兼容项目使用的Crystal版本和字段约定仍需在目标项目检查。
指南
按步骤完成操作，并通过示例核对输入与结果。
粘贴完整JSON或载入示例，检查字段名、层级和样例值是否有代表性。
填写根类型名称。Crystal目标页会选用Crystal输出；其他语言需通过语言页签进入对应页面。
查看生成区域。JSON语法错误时会显示错误，修复逗号、引号、括号或转义后再检查。
检查高级选项中的Crystal及通用设置，确认符合项目约定，再复制或下载代码。
例如输入{"userName":"Lin","age":25,"active":true}，生成结果会按样例结构表达字段。若真实数据中age可能缺失、为null或是小数，应在样例中覆盖这些情形，或在生成后手动调整。遇到嵌套数据，例如{"profile":{"name":"Lin"},"tags":["news","science"]}，应检查生成的父子类型与数组元素类型是否符合预期。
从样例推断类型不能保证覆盖所有合法数据。空数组没有可观察的成员类型，混合类型数组也可能需要手工复核。检查输出比直接复制到生产项目更稳妥。
场景
查看这项工具在不同工作与生活流程中的用法。
开发者可从脱敏响应样例生成类型骨架，再对照接口说明补充可选字段、枚举值和版本变化。
将JSON配置转为Crystal定义后，把结果放入项目并核验字段名及默认值处理约定。
初学者可比较JSON层级与生成类型结构，再通过官方文档了解序列化和反序列化行为。
问答
集中解答高频疑问与容易混淆的问题。
生成器按样例推断类型，但一条样例无法覆盖缺失字段及版本差异。检查生成代码，并按Crystal版本和实际数据补充可空类型或映射。
检查对象键和值是否使用双引号、逗号和括号是否匹配，并正确转义字符串中的引号。空输入不会生成代码。
它是样例生成的类型草稿。请在项目使用的Crystal版本编译，并检查字段映射、可选字段、数值类型、校验及序列化行为。
须知
使用前了解适用范围、结果限制与必要提醒。
样例生成结果不能证明完整数据模式。接口可能新增字段、改变类型或省略值；请对照正式schema、接口文档及多条真实样例核查。特殊字段名、精度、序列化注解和校验逻辑可能需要手动处理。
JSON含个人资料、凭据或内部业务信息时，应先移除或替换敏感值。本工具不构成数据安全审计或Crystal编译验证；生成代码应在自己的开发环境中测试。
推荐
查找相关工具、专题与可用的 API 能力。
