Ruby 日志记录入门：用好 Logger、分清级别与生产环境注意点

程一诺

发布时间：2026-08-24| 6人浏览过

原创

前言

日志记录在前端场景里不算显眼，但在后端服务、脚本任务和运维排障中，它往往就是定位问题的第一入口。Ruby 已经内置了 Logger，入门门槛不高，但真正写得有用，关键在于理解日志级别、输出方式和生产环境下的控制策略。下面按“先能用、再好用”的顺序梳理 Ruby 日志记录的核心做法，并说明哪些地方适合直接上手，哪些地方需要额外留意。

Ruby 为什么要用日志

对 Ruby 应用来说，日志最直接的作用有三类：记录运行过程、保留错误现场、帮助后续排查。尤其是在服务端程序里，很多问题无法只靠报错提示复现，这时日志就是判断程序做过什么、在哪一步出错的主要依据。

展示 Ruby Logger 常见日志级别及适用场景的白底信息图 — **Ruby Logger 日志级别一览**用一张图看懂 Ruby 日志级别从 DEBUG 到 FATAL 的用途差异。

Ruby 标准库自带 Logger，不需要额外安装就可以使用。它支持按级别输出日志，你可以通过不同级别控制信息密度和用途。

常见日志级别怎么区分

DEBUG：调试信息，用于追踪程序内部的工作流程。
INFO：一般信息，记录程序的主要操作。
WARN：警告信息，表示可能存在问题的情况。
ERROR：错误信息，表示已经影响到程序正常工作的错误。
FATAL：致命错误，通常意味着程序无法继续运行。

实际使用时，可以把它理解为一套筛选机制：级别越高，通常越偏向必须关注的问题；级别越低，越适合开发和排查阶段补充上下文。

Ruby Logger 的基础用法

如果你只是想先把日志打出来，Logger 的基本流程很简单：引入库、创建实例、设置级别、开始记录。

展示 Ruby Logger 基础配置流程的白底信息图 — **Ruby Logger 最短上手流程**把引入库、创建实例、设置级别和输出日志串成一条最短上手路径，适合初学者快速建立使用顺序。

先加载 logger 库

require 'logger'

大多数 Ruby 项目里，这一步就够了。

创建 Logger 实例并指定输出位置

logger = Logger.new(STDOUT)

这里的 STDOUT 表示标准输出，也就是直接打印到控制台。对于命令行工具、开发环境脚本或临时调试，这是最直接的方式。若要写入文件，也可以把输出目标换成文件路径或文件对象。

设置日志级别

logger.level = Logger::DEBUG # 或者其他级别，如 Logger::INFO, Logger::WARN 等

这一步决定了哪些日志会被真正输出。比如设置为 Logger::INFO 后，通常就不会再看到 DEBUG 级别的信息。

按不同级别记录日志

完成实例创建后，就可以直接通过对应方法写日志：

logger.debug("这是调试信息")
logger.info("这是一个信息级别的日志")
logger.warn("这里有一个警告")
logger.error("发生了一个错误")
logger.fatal("致命错误，程序即将退出")

这种写法适合先把程序运行轨迹和错误现场记录下来。后续如果要进一步提升可读性，再考虑格式化和分流输出。

想让日志更好用，可以从这两项开始

Logger 的基础功能足以覆盖不少场景，但如果你开始关注排查效率，通常会先碰到两个问题：默认输出够不够看、日志是否需要同时发往多个目标。

自定义日志格式

默认格式比较简洁，但在多人协作或线上排错时，往往希望把时间、级别和消息组织得更清楚。这时可以自定义格式化器：

formatter = proc do |severity, datetime, progname, msg|
  "#{datetime}: #{severity} #{msg}n"
end

logger.formatter = formatter

这段代码保留了时间戳、日志级别和正文消息。虽然示例很简单，但思路很实用：你可以按团队需要补充更稳定的输出格式，方便后续检索和分析。

同时写到控制台和文件

有些程序既希望在终端即时看到输出，也希望把日志持久化到文件中。原文给出了一个多输出目标示例：

file_log = Logger.new('app.log')
logger.extend(Logger::Severity).add(Logger::Severity::DEBUG, "写入文件的日志")
logger.add(Logger::Severity::DEBUG, "写入控制台的日志")

这里需要特别注意：上述代码更适合作为思路展示，而不是可直接照搬的标准实现。实际项目里，通常需要为每个输出目标分别创建 Logger 实例，或者引入更完整的日志管理方案，否则行为会比较难控制。