如何修改Active Model的YAML序列化格式？

我完全懂你现在的困扰——用YAML把数据库内容导出到Git追踪变更本来挺顺畅，但嵌入的JSON被压成单行字符串，哪怕改个小字段，Diff都能乱得让人头疼。你试过的那几种方法没起作用，是因为Rails的ActiveRecord在YAML序列化时走了自己的一套流程，咱们得从序列化的核心逻辑入手调整。

这里有两个实用的解决方案，你可以根据自己的场景选：

方案一：在模型中重写序列化逻辑（简单直接） #

针对你的Grammar模型，我们可以重写encode_with方法——这是ActiveRecord处理YAML序列化的关键钩子。在默认序列化完成后，把model属性的JSON字符串解析成Ruby哈希，这样YAML就会把它格式化成多行结构：

class Grammar < ApplicationRecord
  def encode_with(coder)
    # 先执行默认的序列化逻辑
    super
    # 把JSON字符串解析为Ruby哈希，替换原有的单行值
    return unless model.present?
    
    begin
      coder['model'] = JSON.parse(model)
    rescue JSON::ParserError
      # 万一JSON格式有问题， fallback到原字符串避免报错
      coder['model'] = model
    end
  end
end

这样处理后，导出的YAML里model就不再是一坨单行字符串，而是结构化的层级内容，Diff的时候就能精准显示具体字段的变化了。

方案二：自定义YAML编码器（全局/多模型复用） #

如果你需要给多个模型做类似处理，或者不想侵入单个模型的代码，可以自定义一个YAML编码器，替换ActiveRecord默认的编码器：

首先创建自定义编码器类：

class FormattedJsonYAMLEncoder < ActiveModel::AttributeSet::YAMLEncoder
  def encode(attribute)
    value = attribute.value_before_type_cast
    # 针对指定属性（这里是model）处理JSON格式化
    if attribute.name == 'model' && value.is_a?(String)
      begin
        # 解析JSON后用YAML格式化，strip去掉多余换行
        YAML.dump(JSON.parse(value)).strip
      rescue JSON::ParserError
        super
      end
    else
      # 其他属性用默认逻辑处理
      super
    end
  end
end

然后在模型中指定使用这个编码器：

class Grammar < ApplicationRecord
  def attributes_to_yaml
    attribute_set.to_yaml(encoder: FormattedJsonYAMLEncoder.new)
  end
end

这个方法更灵活，你可以扩展编码器的逻辑，比如支持多个JSON属性，或者给不同模型做不同处理。

效果示例 #

调整后，你的model属性在YAML中会变成这样的结构化内容：

model:
  root: element
  types:
    if:
      type: concrete
      attributes:
        - name: condition
          type: allowed
          nodeTypes:
            - expr
        - name: body
          type: allowed
          nodeTypes:
            - occurs: "*"
              nodeType: element
            # ... 其余结构

现在哪怕只修改了types.if.attributes[0].name这样的小字段，Git Diff只会高亮那一行的变化，再也不会出现整个长字符串替换的混乱情况了。

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