Ruby中如何实现类似Java SLF4J的无依赖日志方案，减少对调用代码假设

和Java生态的SLF4J思路一致，Ruby生态下开发gem时可以通过「门面接口+运行时注入」的方式，完全不预设调用方的日志实现，也不需要对调用代码做额外假设，具体实现步骤如下：

1. 遵循生态通用日志接口约定 #

Ruby生态几乎所有主流日志实现（包括标准库Logger、log4r、semantic_logger等）都遵循统一的方法约定，都支持debug/info/warn/error/fatal五个等级的日志方法，以及level属性配置，不需要自定义全新的接口规范，只需要默认适配这套约定即可。

你只需要在gem内部暴露可配置的logger入口，同时提供最小兜底实现：

module YourGem
  class Configuration
    attr_accessor :logger
  end

  class << self
    attr_writer :configuration

    def configuration
      @configuration ||= Configuration.new
    end

    def configure
      yield(configuration)
    end

    # gem内部统一调用该方法输出日志
    def logger
      configuration.logger ||= default_stdout_logger
    end

    private
    # 兜底用标准库自带的Logger，无额外依赖
    def default_stdout_logger
      require 'logger'
      @default_logger ||= Logger.new($stdout).tap do |l|
        l.level = Logger::INFO
      end
    end
  end
end

2. 不引入任何日志实现依赖 #

不要在gem的gemspec中将任何第三方日志库声明为runtime依赖，默认兜底实现仅使用Ruby标准库自带的Logger，所有Ruby运行环境都默认支持，不会产生额外依赖冲突。

调用方可以自由注入任意符合约定的日志实现，不需要修改你的gem内部代码：

# 调用方用自定义日志实现的配置示例
YourGem.configure do |config|
  config.logger = SemanticLogger['YourGem'] # 用semantic_logger
  # 或者 config.logger = Rails.logger # 用Rails框架自带的日志
  # 或者 config.logger = Log4r::Logger.new('YourGem') # 用log4r
end

3. 内部日志调用遵循最小约定 #

gem内部输出日志时，仅使用通用的debug/info/warn/error/fatal方法，不要调用特定日志实现独有的特殊方法（比如部分实现才有的tagged、with_context等），即可保证100%兼容所有符合规范的日志实现。

如果需要输出结构化日志，直接传入哈希参数即可，主流日志实现都支持该格式：

YourGem.logger.info("操作执行完成", user_id: 123, action: "update_profile")

4. 可选添加兼容适配器（进阶） #

如果需要兼容不符合约定的自定义日志实例，可以加一层薄适配器做自动兜底：

module YourGem
  class LoggerAdapter
    def initialize(raw_logger)
      @raw_logger = raw_logger
    end

    %w[debug info warn error fatal].each do |level|
      define_method(level) do |msg = nil, **kwargs, &block|
        if @raw_logger.respond_to?(level)
          @raw_logger.public_send(level, msg, **kwargs, &block)
        else
          puts "[#{level.upcase}] #{msg || block&.call}"
        end
      end
    end
  end
end

在logger配置时自动套上适配器即可，哪怕用户传入的实例没有对应方法也不会报错。

内容的提问来源于stack exchange，提问作者Asad Iqbal