Ruby on Rails中如何正确对Numeric类进行猴子补丁及配置加载？

我来帮你搞定这个问题～你遇到的uninitialized constant CoreExtensions错误，本质是Rails启动时还没加载到你的扩展模块文件，咱们一步步按Rails的约定来修复：

1. 规范扩展文件的存放路径 #

先把你的扩展模块放到项目的lib/core_extensions/目录下，创建文件lib/core_extensions/numeric.rb，内容就是你写的代码：

# frozen_string_literal: true
module CoreExtensions
  module Numeric
    def percent_of(number)
      to_f / number * 100.0
    end
  end
end

2. 让Rails能识别并加载lib目录下的文件 #

根据你的Rails版本，在config/application.rb里配置自动加载规则：

• Rails 7+（使用Zeitwerk自动加载器）：

  Rails.application.configure do
    # 其他原有配置...
    config.autoload_lib(ignore: %w(assets tasks))
  end
  

• Rails 6及以下版本：

  Rails.application.configure do
    # 其他原有配置...
    config.autoload_paths << Rails.root.join('lib')
  end
  

3. 在初始化器中加载扩展（最推荐的方式） #

这是符合Rails约定的最佳实践：在config/initializers/目录下新建一个文件，比如core_extensions.rb，内容如下：

# frozen_string_literal: true
# 如果你配置了Zeitwerk自动加载，不需要手动require，直接执行include即可
Numeric.include CoreExtensions::Numeric

# 要是没配置自动加载，就先手动引入文件再执行include：
# require Rails.root.join('lib/core_extensions/numeric')
# Numeric.include CoreExtensions::Numeric

这样Rails启动时，初始化器会在核心框架代码加载完成后执行，此时你的CoreExtensions::Numeric模块已经被成功加载，就不会再出现常量未初始化的错误了。

额外的最佳实践小提示 #

• 你用CoreExtensions模块包装扩展的做法非常棒，能有效避免全局命名空间污染，继续保持～
• 可以给扩展模块加个加载保护，防止重复注入方法：

  module CoreExtensions
    module Numeric
      def self.included(base)
        base.class_eval do
          unless method_defined?(:percent_of)
            def percent_of(number)
              to_f / number * 100.0
            end
          end
        end
      end
    end
  end
  

• 验证一下：启动Rails控制台，执行50.percent_of(200)，如果返回25.0，就说明你的扩展已经成功生效啦！

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