为何ApplicationRecord.descendants.count返回1？明明存在多个子类模型

这个问题我之前排查过好多次，核心原因基本都和Rails的自动加载机制脱不了干系，咱们一步步拆解来看：

最常见的诱因：模型还没被自动加载 #

Rails在开发环境（控制台默认用的就是这个环境）采用懒加载策略——只有当你实际引用某个模型类（比如在控制台敲User）时，Rails才会去加载对应的模型文件。如果那些继承自ApplicationRecord的子类模型还没被加载到内存里，descendants自然不会把它们算进去，只会返回已经被触发加载的那一个（大概率是你之前不小心引用过的某个模型）。

比如你刚打开控制台就直接敲ApplicationRecord.descendants.count，这时候大部分模型都还在“沉睡”状态，返回值肯定远小于实际数量。

快速解决办法：强制加载所有模型 #

在控制台里执行这段代码，就能一次性加载所有模型文件：

Dir[Rails.root.join('app/models/**/*.rb')].each { |f| require f }

执行完再跑ApplicationRecord.descendants.count，就能得到正确的数值了。

第二个可能：模型文件命名不符合Rails约定 #

Rails的自动加载完全依赖文件名-类名的严格对应规则：

• 模型类User必须对应app/models/user.rb
• 嵌套模型Admin::User必须对应app/models/admin/user.rb
  如果你的模型文件命名出错（比如把User存成app/models/users.rb复数形式，或者类名拼写和文件名不一致），Rails就找不到并加载这个模型，它自然不会出现在descendants列表里。

快速检查方式： #

在控制台直接输入模型类名（比如User），如果弹出NameError: uninitialized constant User的报错，那百分百是命名/路径的问题，修正文件名或类名即可。

第三个可能：开发环境的预加载配置 #

默认情况下，Rails开发环境的config.eager_load是false，这意味着Rails启动时不会预加载所有代码。如果你希望控制台启动时就自动加载所有模型，可以临时修改config/environments/development.rb：

config.eager_load = true

不过要注意，开启这个会让开发环境的启动速度变慢，因为要加载所有文件，所以一般只建议临时测试用，日常开发还是保持默认配置更高效。

最后验证： #

加载完所有模型后，你可以用ApplicationRecord.descendants.map(&:name)列出所有子类的名称，确认是不是所有模型都被正确加载了。

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