Crystal 转换说明与类型映射

工具特点

• JSON::Serializable：Crystal 标准库提供的极其强大的模块。开启此选项后，工具会自动为你加上 include JSON::Serializable，并且为每一个字段显式标注 @[JSON::Field(key: "...")] 注解，确保 JSON 键名能够绝对精准地映射到内部的属性。
• 智能属性名转换：Crystal 推荐属性使用下划线命名 (snake_case)。如果 JSON 键名含有连字符或大写字母，工具会自动将其转换为标准下划线格式，同时保留原 JSON 的映射。
• Struct 与 Class 的选择：在 Crystal 中，如果你的数据只用于纯粹的数值传递且生命周期短，推荐切换到 struct（分配在栈上，性能更高）；否则使用默认的 class（分配在堆上，支持继承）。

类型映射规则

• String ➜ string
• Number (整数) ➜ int
• Number (小数) ➜ float
• Boolean ➜ boolean
• Array ➜ array(Type) 或 array(mixed)
• Null / Undefined ➜ mixed (Pike 中的万能类型，当工具无法精确推断时使用)