RSpec中针对全局可用对象，expect参数应如何设置？

1. 消除无意义占位符，让匹配器自动获取日志源 #

不用再依赖:logging这种生硬的占位符，直接在匹配器内部调用LoggingSpecHelper.log_events获取日志数组。调用方无需传递目标对象，代码更简洁直观。

实现示例（RSpec匹配器） #

RSpec::Matchers.define :have_exactly_one_log_event do |expected_level, expected_message|
  match do |_ignored_target|
    # 筛选符合条件的日志事件
    @matching_events = LoggingSpecHelper.log_events.select do |event|
      event.level == expected_level && Regexp.new(Regexp.escape(expected_message)).match?(event.message)
    end
    @total_events = LoggingSpecHelper.log_events
    # 验证恰好出现1次
    @matching_events.size == 1
  end

  # 自定义失败提示，包含完整日志上下文
  failure_message do |_ignored_target|
    <<~FAIL_MSG
      预期存在1条级别为#{expected_level.inspect}、消息匹配#{expected_message.inspect}的日志，但实际找到#{@matching_events.size}条。
      所有日志内容：
      #{@total_events.map { |e| "[#{e.level.upcase}] #{e.message}" }.join("\n")}
    FAIL_MSG
  end
end

简化调用方式 #

直接使用expect(nil)作为占位（因为匹配器内部已自动获取日志源）：

expect(nil).to have_exactly_one_log_event(:fatal, 'something is misconfigured')

如果觉得expect(nil)不够自然，可以封装全局辅助方法：

def expect_logs
  OpenStruct.new(
    to: ->(matcher) { expect(nil).to matcher }
  )
end

之后调用更符合语义：

expect_logs.to have_exactly_one_log_event(:fatal, 'something is misconfigured')

2. 重命名匹配器，明确语义 #

将匹配器命名为have_exactly_one_log_event，直接体现“验证日志恰好出现1次”的逻辑，避免与“至少出现1次”的场景混淆。如果后续需要支持其他校验逻辑，可单独定义have_at_least_one_log_event等匹配器，职责更清晰。

3. 可选：用关键字参数提升扩展性 #

如果日志匹配条件需要扩展（比如添加时间范围、上下文标签等），改用关键字参数定义匹配器，可读性和扩展性更强：

RSpec::Matchers.define :have_exactly_one_log_event do |opts|
  expected_level = opts[:level]
  expected_message = opts[:message]

  match do |_ignored_target|
    @matching_events = LoggingSpecHelper.log_events.select do |event|
      event.level == expected_level && Regexp.new(Regexp.escape(expected_message)).match?(event.message)
    end
    @total_events = LoggingSpecHelper.log_events
    @matching_events.size == 1
  end

  # 失败提示逻辑同上...
end

调用方式：

expect_logs.to have_exactly_one_log_event(level: :fatal, message: 'something is misconfigured')

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