如何为Rails 7.0自定义模型分组结构配置Zeitwerk自动加载？

我在基于Rails 7.0、Ruby 3.2的测试应用中尝试使用非默认模型结构，将模型相关代码按业务分组，每组内包含同名的支持模块，目录结构如下：

app/
└── models/
    ├── accounts
    │   ├── account.rb
    │   └── support
    │       └── greetable.rb
    └── users
        ├── user.rb
        └── support
            └── greetable.rb

对应文件内容如下：

# app/models/accounts/account.rb
class Account < ApplicationRecord
  include Greetable
end

# app/models/accounts/support/greetable.rb
module Greetable
  def greet
    "Hello, Account!"
  end
end

# app/models/users/user.rb
class User < ApplicationRecord
  include Greetable
end

# app/models/users/support/greetable.rb
module Greetable
  def greet
    "Hello, User!"
  end
end

原本期望Zeitwerk能自动识别每个模型所在目录下的Greetable模块，但实际并未生效——两个模型最终都会加载到第一个被扫描到的Greetable模块，而非各自目录下的版本。以下是可行的配置思路：

方案1：遵循Zeitwerk命名空间规则（推荐） #

Zeitwerk的核心逻辑是文件路径对应常量命名空间，因此需要将同名模块放入对应业务的命名空间下，避免顶级常量冲突：

1. 修改support目录下的模块定义，添加命名空间嵌套：

# app/models/accounts/support/greetable.rb
module Accounts
  module Support
    module Greetable
      def greet
        "Hello, Account!"
      end
    end
  end
end

# app/models/users/support/greetable.rb
module Users
  module Support
    module Greetable
      def greet
        "Hello, User!"
      end
    end
  end
end

2. 在模型中引入对应命名空间的模块：

# app/models/accounts/account.rb
class Account < ApplicationRecord
  include Accounts::Support::Greetable
end

# app/models/users/user.rb
class User < ApplicationRecord
  include Users::Support::Greetable
end

这种方式完全符合Zeitwerk的自动加载设计，无需额外配置，Zeitwerk会根据目录结构自动识别Accounts::Support::Greetable和Users::Support::Greetable两个独立模块。

方案2：自定义Zeitwerk加载路径优先级 #

如果不想修改模块命名空间，可以通过调整Zeitwerk的加载路径，让每个模型所在目录的support文件夹优先被扫描：

在config/application.rb中添加以下配置：

config.before_configuration do
  # 为每个业务目录的support文件夹添加自动加载路径，并设置优先级
  accounts_support_path = Rails.root.join('app/models/accounts/support')
  users_support_path = Rails.root.join('app/models/users/support')

  # 将路径添加到autoload_paths的最前面，确保优先加载
  config.autoload_paths.unshift(accounts_support_path)
  config.autoload_paths.unshift(users_support_path)
end

但注意：这种方式存在隐患——如果两个Greetable模块同时被加载，Ruby会覆盖已定义的常量（后加载的会覆盖先加载的），因此需要确保模型加载时，对应目录的support模块已被优先加载。可以结合require_dependency在模型中显式指定加载顺序：

# app/models/accounts/account.rb
require_dependency 'accounts/support/greetable'
class Account < ApplicationRecord
  include Greetable
end

# app/models/users/user.rb
require_dependency 'users/support/greetable'
class User < ApplicationRecord
  include Greetable
end

这种方式虽然能解决问题，但违背了Zeitwerk自动加载的设计理念，仅适合临时场景。

问题根源解释 #

Zeitwerk默认会将app/models作为根自动加载路径，扫描所有文件并将路径映射为顶级常量。两个Greetable模块都被解析为顶级::Greetable常量，Ruby中常量一旦定义就无法被重复定义（除非显式覆盖），因此Zeitwerk只会加载第一个被扫描到的版本，后续的同名模块会被忽略。

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