如何在Rails中实现/lib目录下默认类的可重写机制？

针对你用git subtree管理/lib共享类、需要默认加载且允许应用按需覆写的场景，以下是几个更自动化的可行方案：

方案1：自动扫描共享目录，匹配加载应用覆写类 #

这个方案无需手动维护类列表，通过遍历/lib下的共享文件，自动对应到/app目录的同名文件并加载，利用Ruby类的开放性实现方法合并。

在config/initializers/shared_lib_overrides.rb中添加以下代码：

Rails.configuration.to_prepare do
  # 定义共享目录与应用目录的映射关系
  shared_app_mappings = {
    Rails.root.join("lib/shared/models") => Rails.root.join("app/models"),
    Rails.root.join("lib/shared/controllers") => Rails.root.join("app/controllers"),
    # 可根据需求添加services/concerns等其他目录
  }

  shared_app_mappings.each do |shared_root, app_root|
    # 遍历共享目录下所有rb文件
    Dir.glob("#{shared_root}/**/*.rb").each do |shared_file|
      relative_path = Pathname.new(shared_file).relative_path_from(shared_root)
      app_file = app_root.join(relative_path)

      next unless File.exist?(app_file)

      # 从文件路径转换为类名（例如admin/user.rb → Admin::User）
      class_name = relative_path.to_s.gsub(".rb", "").split("/").map(&:camelize).join("::")
      # 确保共享类已加载
      require_dependency shared_file
      # 加载应用中的覆写类，实现方法合并
      require_dependency app_file
    end
  end
end

关键细节： #

• 使用require_dependency而非require：确保开发环境下文件修改后能自动重载，符合Rails的代码热加载机制。
• 依赖Rails内置方法：camelize和underscore（ActiveSupport提供）自动处理路径与类名的转换，无需自定义to_underscores。

方案2：封装为Rails引擎（推荐长期维护） #

如果共享类体系复杂，将其封装为Rails引擎是更符合Rails最佳实践的方案，引擎天然支持“默认实现+应用覆写”的模式，且扩展性更强。

步骤： #

1. 创建Rails引擎：

rails plugin new shared_core --mountable

2. 将原/lib下的共享类迁移到引擎的对应目录（例如shared_core/app/models/、shared_core/app/controllers/）。
3. 在应用的Gemfile中引入引擎（基于git subtree的路径）：

gem 'shared_core', path: './vendor/shared_core' # 路径根据你的subtree位置调整

4. 在引擎的lib/shared_core/engine.rb中添加加载逻辑，确保先加载引擎类，再加载应用覆写类：

module SharedCore
  class Engine < ::Rails::Engine
    config.to_prepare do
      # 加载引擎内的所有共享类
      Dir.glob("#{root}/app/**/*.rb").each do |engine_file|
        require_dependency engine_file
      end

      # 加载应用中对应引擎类的覆写文件
      Dir.glob("#{root}/app/**/*.rb").each do |engine_file|
        relative_path = Pathname.new(engine_file).relative_path_from(root.join("app"))
        app_file = Rails.root.join("app", relative_path)
        require_dependency app_file if File.exist?(app_file)
      end
    end
  end
end

优势： #

• 遵循Rails生态规范，后续新增共享类只需放到引擎对应目录，无需修改初始化代码。
• 天然支持依赖管理、路由挂载（若需要）等高级特性，适合复杂的共享组件场景。

方案对比 #

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