Ruby 元编程：define_method 与 instance_eval

Ruby 的元编程能力让你能在程序运行时动态创建或修改代码。其中，define_method 和 instance_eval 是两个最常用、也最容易混淆的工具。它们都能用来定义方法，但作用时机、作用对象和使用场景完全不同。掌握它们的区别，能让你写出更灵活、更简洁的代码。

理解 define_method：在类中动态定义实例方法

define_method 是一个类方法，用于在类的上下文中动态创建实例方法。它不会改变当前的执行上下文（即 self），只是告诉类：“从现在起，所有该类的实例都拥有这个新方法”。

使用 define_method 的核心步骤：

1. 进入类定义内部（例如通过 class MyClass）。
2. 调用 define_method，传入方法名（字符串或符号）和一个代码块。
3. 代码块中的逻辑将成为新方法的实现，该方法对所有实例可用。

class Greeter
  define_method :say_hello do |name|
    "Hello, #{name}!"
  end
end

g = Greeter.new
puts g.say_hello("Alice")  # 输出: Hello, Alice!

注意：define_method 定义的方法是实例方法，不是类方法。如果你希望定义类方法，需要在类的单例类（eigenclass）中使用它：

class MathUtils
  class << self
    define_method :double do |x|
      x * 2
    end
  end
end

puts MathUtils.double(5)  # 输出: 10

define_method 的优势在于：

• 方法名可以是变量（动态生成）。
• 可以访问定义时的局部变量（闭包特性）。

例如，批量定义属性读取器：

class Config
  %i[host port timeout].each do |attr|
    define_method attr do
      @settings&.fetch(attr, nil)
    end
  end

  def initialize(settings = {})
    @settings = settings
  end
end

c = Config.new(host: "localhost", port: 8080)
puts c.host    # localhost
puts c.port    # 8080

理解 instance_eval：在对象上下文中执行代码

instance_eval 是一个实例方法，用于在特定对象的上下文中执行一段代码。执行时，self 会被临时设为该对象，因此你可以在其中直接定义单例方法（即只属于该对象的方法）。

使用 instance_eval 的核心步骤：

1. 获取一个对象（可以是普通实例，也可以是类对象）。
2. 对该对象调用 instance_eval，传入一个代码块。
3. 在代码块中，self 就是该对象，你可以直接使用 def 定义方法。

greeter = Object.new

greeter.instance_eval do
  def greet(name)
    "Hi, #{name}!"
  end
end

puts greeter.greet("Bob")  # 输出: Hi, Bob!

注意：这里定义的 greet 方法只属于 greeter 这一个对象，其他 Object 实例无法调用它。

当 instance_eval 作用于类对象时，由于类本身也是对象，此时在 instance_eval 块中定义的方法会成为类方法：

class API
end

API.instance_eval do
  def base_url
    "https://api.example.com"
  end
end

puts API.base_url  # 输出: https://api.example.com

这等价于：

class API
  def self.base_url
    "https://api.example.com"
  end
end

instance_eval 的关键特性：

• 改变 self，使你能在对象内部“直接写代码”。
• 常用于 DSL（领域特定语言）设计，比如 Rails 的路由配置。

对比：何时用 define_method，何时用 instance_eval？

虽然两者都能定义方法，但适用场景不同。下表总结了核心区别：

下面是一个典型应用场景对比：

# 使用 define_method：为类定义多个实例方法
class Validator
  %w[email phone zip].each do |field|
    define_method "validate_#{field}" do
      puts "Validating #{field}..."
    end
  end
end

v = Validator.new
v.validate_email  # Validating email...

# 使用 instance_eval：为单个对象添加专属行为
user = User.new("Alice")
user.instance_eval do
  def premium?
    true
  end
end

# 其他 User 实例没有 premium? 方法

实战：结合两者构建灵活的配置系统

有时你需要同时利用两者的优点。例如，创建一个能动态生成类方法和实例方法的 DSL：

class Endpoint
  def self.endpoint(name, &block)
    # 使用 instance_eval 在类上下文中定义类方法
    instance_eval do
      define_method name do
        instance_eval(&block)  # 在实例上下文中执行用户代码
      end
    end
  end
end

class UserAPI < Endpoint
  endpoint :list do
    "GET /users"
  end

  endpoint :create do
    "POST /users"
  end
end

api = UserAPI.new
puts api.list    # GET /users
puts api.create  # POST /users

这里：

• 外层 instance_eval 让 define_method 在 UserAPI 类中执行，从而定义实例方法 list 和 create。
• 内层 instance_eval(&block) 让用户提供的代码块在实例上下文中运行，可以访问实例变量。

选择 define_method 当你需要在类中动态创建实例方法；选择 instance_eval 当你需要在特定对象（包括类）的上下文中直接编写代码，尤其是定义单例方法或构建 DSL。