Ruby中如何require文件且仅将常量纳入指定模块而非Object？

默认情况下，Ruby的require和require_relative会在顶级Object作用域执行文件代码，导致文件里的常量直接全局可用，很容易引发命名冲突。不过通过元编程，我们可以把目标文件的代码限定在指定模块的上下文里运行，实现你想要的隔离效果。

方案一：自定义模块内加载方法（无需修改被加载文件） #

我们可以给Module类扩展一个方法，让它能在当前模块的作用域内加载并执行目标文件的代码。这样文件里的所有常量都会被定义在这个模块内部，不会污染全局命名空间。

class Module
  def require_into(relative_path)
    # 获取调用者所在目录，拼接出文件的绝对路径
    caller_dir = File.dirname(caller_locations.first.path)
    full_path = File.expand_path(relative_path, caller_dir)

    # 读取文件源代码
    file_content = File.read(full_path)

    # 在当前模块的上下文里执行代码，同时保留原文件的错误行号信息
    module_eval(file_content, full_path, 1)
  end
end

使用方式 #

module Bar
  require_into './foo.rb'
end

# 测试隔离效果
Foo.hello_world # 抛出 NameError: uninitialized constant Foo
Bar::Foo.hello_world # 输出 Hello, World.

原理拆解 #

• caller_locations.first.path能拿到调用require_into的文件路径，这样我们可以正确解析相对路径。
• module_eval是核心：它会把传入的代码字符串在当前模块的作用域内执行，所以foo.rb里定义的module Foo会成为Bar的嵌套模块，而不是全局的Foo。
• 传入full_path和1是为了让报错信息能指向原文件的行号，方便调试，不然错误会显示在module_eval这一行。

如果需要像原生require一样缓存已加载的文件，可以加上缓存逻辑：

class Module
  # 用类变量记录已加载的文件绝对路径
  @@loaded_into_files = {}

  def require_into(relative_path)
    caller_dir = File.dirname(caller_locations.first.path)
    full_path = File.expand_path(relative_path, caller_dir)

    # 如果已经加载过，直接返回
    return if @@loaded_into_files[full_path]

    file_content = File.read(full_path)
    module_eval(file_content, full_path, 1)

    @@loaded_into_files[full_path] = true
  end
end

方案二：手动包装临时模块（需要修改被加载文件） #

如果你有权修改foo.rb，可以先把文件内容放在一个临时模块里，加载后再把目标常量移动到指定模块：

修改foo.rb：

# 用一个唯一的临时模块包裹目标代码，避免全局污染
module TempFooContainer
  module Foo
    def self.hello_world
      puts 'Hello, World.'
    end
  end
end

然后加载并移动常量：

module Bar
  require_relative './foo.rb'
  # 把临时模块里的Foo转移到Bar下
  const_set(:Foo, TempFooContainer::Foo)
  # 移除临时模块，清理全局空间
  Object.send(:remove_const, :TempFooContainer)
end

# 测试
Bar::Foo.hello_world # 正常输出
Foo # 抛出 NameError: uninitialized constant Foo

这个方案的缺点是需要修改被加载的文件，但不需要自定义方法，适合小规模场景。

注意点 #

• 不管用哪种方案，如果被加载的文件里还有其他require调用，那些文件的代码还是会在全局作用域执行，除非你也用require_into来加载它们。
• module_eval会执行文件里的所有代码，包括顶级的方法定义（如果有的话），这些方法会成为当前模块的实例方法，需要注意这一点。

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