如何屏蔽Guard中RSpec的“Failed Examples...”与“Finished in...”输出

安全阿岳

2026-7-17

解决Guard+RSpec输出精简问题

核心结论

你提到的绿色失败示例列表属于RSpec默认格式化器（Formatter）的输出，蓝色区域大概率是Guard的运行提示或RSpec的汇总信息。可以通过自定义RSpec格式化器+Guard配置调整实现完全屏蔽绿色区域、精简蓝色区域的需求。

步骤1：自定义RSpec格式化器，屏蔽失败示例列表

创建一个极简格式化器，继承RSpec默认的进度格式化器，重写方法跳过冗余输出：

在spec/support/目录下创建compact_formatter.rb文件：

require 'rspec/core/formatters/progress_formatter'

class CompactFormatter < RSpec::Core::Formatters::ProgressFormatter
  # 完全屏蔽绿色的「Failed examples」列表
  def dump_failures(_notification)
    # 空实现，不输出任何失败示例条目
  end

  # 精简汇总信息（替换蓝色区域的冗长内容）
  def dump_summary(summary)
    output.puts "\n🔍 #{summary.example_count} examples | ❌ #{summary.failure_count} failures | ⏱️ #{summary.duration.round(2)}s"
  end
end

在.rspec配置文件中启用这个格式化器：

--require spec/support/compact_formatter.rb
--format CompactFormatter

步骤2：调整Guard配置，精简蓝色区域输出

在Guardfile中添加quiet: true参数，减少Guard自身的冗余提示，同时确保使用自定义格式化器：

guard :rspec, cmd: 'bundle exec rspec', quiet: true do
  # 你的文件监听规则，比如：
  watch(%r{^spec/.+_spec\.rb$})
  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
  watch('spec/spec_helper.rb')  { 'spec' }
end

quiet: true会关闭Guard的启动提示、重复运行的冗余说明，只保留RSpec的精简输出。