Crystal中结构体调用to_json为何需include JSON::Serializable？

自定义结构体/类默认无法直接调用.to_json方法，必须显式混入JSON::Serializable模块，这是Crystal的设计特性决定的：

• Crystal的核心类型体系默认不内置JSON序列化逻辑，所有和JSON编解码相关的能力都封装在JSON::Serializable模块中，避免所有类型都冗余携带不需要的方法，减少编译产物体积、提升运行效率。
• include JSON::Serializable本质是触发编译期宏展开：编译器会在编译阶段扫描当前类型的所有实例变量定义，自动生成匹配字段类型、数量的.to_json序列化方法、以及对应的from_json反序列化方法，不需要开发者手动编写逐字段处理的重复代码。
• 如果不添加该混入语句，直接调用.to_json会在编译阶段直接抛出方法不存在的错误——Crystal是静态编译型语言，所有方法的存在性校验、调用绑定都在编译期完成，不会留到运行时才报错。

可用的最小实现示例：

struct Book
    include JSON::Serializable # 混入后自动生成JSON编解码相关方法
    def initialize(
      @Id : Int32,
      @Title : String,
      @Author : String,
      @Desc : String
    )
    end
end

# 调用示例
book = Book.new(1, "Crystal入门", "TestAuthor", "Crystal基础语法教程")
puts book.to_json # 正常输出对应JSON字符串

如果需要自定义序列化规则，比如修改字段输出名、忽略指定字段、自定义特殊类型的编解码逻辑，可以通过给实例变量添加JSON::Field注解实现，不需要重写整个to_json方法。

内容的提问来源于stack exchange，提问作者learncodes123