Rails如何自动加载指定文件夹中的模型子类数组？

1. 先确认子类的命名与目录结构匹配 #

models/custom_classes/ 下的每个子类文件，必须遵循 Rails 的自动加载规则：

• 文件名用蛇形命名（比如 bar_baz.rb）
• 类定义要放在 CustomClasses 模块下，且继承自 CustomClass，示例：

# app/models/custom_classes/bar_baz.rb
module CustomClasses
  class BarBaz < CustomClass
    # 子类逻辑
  end
end

2. 实现自动收集子类的方法 #

Rails 中 Class#subclasses 方法可以返回已加载的子类，但开发环境是懒加载模式，子类不会自动全部加载，所以需要先确保所有子类文件被加载，再收集。

在 app/models/custom_class.rb 中修改方法：

class CustomClass < ApplicationRecord
  def self.available_from_my_class
    # 加载custom_classes目录下的所有子类文件
    Dir[Rails.root.join('app/models/custom_classes/**/*.rb')].each do |file|
      require_dependency file
    end

    # 返回所有继承自CustomClass的子类
    subclasses
  end
end

如果只想收集 CustomClasses 命名空间下的子类，可以加过滤：

def self.available_from_my_class
  Dir[Rails.root.join('app/models/custom_classes/**/*.rb')].each do |file|
    require_dependency file
  end

  subclasses.select { |klass| klass.name.start_with?('CustomClasses::') }
end

3. 为什么之前的 CustomClasses::Subclasses.all 报错？ #

Rails 并没有内置 CustomClasses::Subclasses 这个常量，这不是 Rails 的默认机制，所以会提示未初始化常量。你需要手动处理子类的加载与收集逻辑。

额外注意事项 #

• 生产环境默认会预加载所有模型文件，所以 subclasses 能直接返回全量子类，无需额外加载；开发环境因为懒加载，必须通过 require_dependency 主动加载文件。
• 确保文件名和类名严格对应（蛇形文件名 ↔ 驼峰类名），否则 Rails 无法正确加载类。

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