安装Rails后Minitest插件（如minitest/pride）失效问题排查

问题描述 #

有两个Ruby项目（1个Rails项目、1个原生Ruby项目），均使用Ruby 3.0.3。打包Rails项目前，原生Ruby项目运行rake test时Minitest::Pride插件可正常加载生效；但打包Rails项目后，该项目运行rake test时恢复为旧的红/绿配色，插件失效。

有趣的是，在完整Rails项目中运行rails test时Minitest::Pride可正常加载。后续发现，在Ruby项目中执行bundle exec rake test可解决问题，但仍需明确原因（两个项目使用相同版本的rake和minitest gems）。

项目文件结构（简化版） #

ruby-project/
  -- test/
    -- example_test.rb
    -- test_helper.rb
  Gemfile
  Rakefile
rails-project/
  -- Gemfile

核心文件内容 #

ruby-project/test/example_test.rb

require "test_helper"

class ExampleTest < Minitest::Test
  25.times do |i|
    define_method "test_success#{i}" do
      assert true
    end
  end
end

ruby-project/test/test_helper.rb

require "minitest/autorun"
require "minitest/pride"

ruby-project/Gemfile

source "https://rubygems.org"

gem "rake"
gem "minitest"

ruby-project/Rakefile

require "rake/testtask"

Rake::TestTask.new(:test) do |t|
  t.libs = %w(lib test)
  t.pattern = "test/**/*_test.rb"
end

task :default => :test

rails-project/Gemfile

source "https://rubygems.org"

ruby "3.0.3"
gem "rails", "~> 7.0.3"

复现步骤 #

• 搭建上述两个项目
• 执行rbenv install 3.0.3
• 进入ruby-project目录执行bundle
• 进入ruby-project目录执行rake test（Minitest::Pride插件加载生效）
• 进入rails-project目录执行bundle
• 进入ruby-project目录执行rake test（Minitest::Pride插件未加载）

已尝试的解决方法 #

• 为两个项目锁定相同版本的Minitest（5.16.3和5.17.0）
• 锁定Rails版本为7.0.3.1和7.0.4.2
• 先打包Rails项目

问题原因分析 #

1. Bundle环境的全局干扰 #

执行bundle命令时，会临时修改当前shell的环境变量（如GEM_PATH、BUNDLE_GEMFILE），将gem查找路径指向当前项目的bundle目录：

• 第一次在ruby-project执行bundle后，shell环境指向该项目的bundle，直接执行rake test会加载项目依赖的minitest，test_helper.rb中的require "minitest/pride"正常生效。
• 进入rails-project执行bundle后，shell环境变量被更新为指向rails项目的bundle。回到ruby-project时，若不使用bundle exec，执行的rake会沿用rails项目的bundle环境，而非ruby-project自己的。

2. Rails对Minitest的插件覆盖 #

即使两个项目的minitest版本相同，Rails自带的Minitest集成插件（如rails/test_unit/minitest_plugin.rb）会修改Minitest的默认输出格式。当在rails项目的bundle环境下执行ruby-project的rake test时，Rails的Minitest插件会被自动加载，覆盖Minitest::Pride的配色效果，导致插件失效。

3. bundle exec的隔离作用 #

bundle exec会强制命令在当前项目的bundle隔离环境中运行，确保加载的gem、插件均来自项目自身的Gemfile.lock，不受其他项目的bundle环境干扰，因此minitest/pride能正常加载生效。

解决方案 #

长期解决方案 #

在原生Ruby项目中执行测试时，始终使用bundle exec rake test，确保命令运行在项目专属的bundle环境中，避免其他项目的gem环境干扰。

可选优化 #

• 在ruby-project的Gemfile中明确指定minitest-pride gem（虽然minitest本身包含pride，但显式声明可强化依赖隔离）：

  gem "minitest"
  gem "minitest-pride"
  

• 为每个项目使用独立的rbenv gemset（如rbenv gemset create 3.0.3 ruby-project），彻底隔离不同项目的gem环境。

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