升级Rails：如何在development.rb执行前自动加载常量？

问题原因 #

Zeitwerk自动加载机制的初始化是在Rails启动流程的后期阶段完成的，而development.rb这类环境配置文件加载时，自动加载系统还未就绪。这就是为什么你在控制器中能正常使用Settings常量（控制器加载时自动加载已生效），但在配置文件里会触发未初始化常量错误——即便你添加了autoload_paths和eager_load_paths，这些配置也要等自动加载系统启动后才会生效。

解决方案 #

1. 手动require目标文件（推荐）

直接在development.rb的开头手动加载settings.rb，此时Rails.root已经可以正常使用：

# config/environments/development.rb
require Rails.root.join('lib', 'settings')

# 后续配置代码即可正常使用Settings常量
config.some_setting = Settings.app_name

这种方式针对性强，只在需要的环境配置文件中加载，不影响其他环境的启动流程。

2. 在application.rb中全局提前加载

如果需要在所有环境的配置文件中都使用Settings，可以在application.rb的顶部（Rails.application.initialize!之前）加入加载代码：

# config/application.rb
require_relative '../lib/settings'

module YourAppName
  class Application < Rails::Application
    # ... 其他配置
    config.autoload_paths << "#{Rails.root}/lib"
    config.eager_load_paths << "#{Rails.root}/lib"
    # ...
  end
end

这样所有环境配置文件（development.rb、production.rb等）加载时，Settings常量已经存在。

3. 强制开启eager_load（不推荐开发环境）

开发环境默认eager_load = false，如果强制开启，Rails会在启动时预加载所有eager_load_paths下的文件，包括lib目录：

# config/environments/development.rb
config.eager_load = true

但此方法会导致开发时修改lib文件后必须重启服务器，严重影响开发效率，仅建议在生产环境或特殊场景使用。

注意事项 #

• 确保lib/settings.rb的命名符合Zeitwerk规范：常量名Settings对应文件名settings.rb（小写蛇形命名），你的文件已经符合要求，无需调整。
• 如果lib下有子目录，需保持目录结构与常量命名一致，例如Lib::Api::Settings对应lib/api/settings.rb。

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