Rails 6（Edge）中test_helper、rails_helper、spec_helper的区别与疑问

首先得明确一个核心前提：Rails 6默认自带的是Minitest测试框架，所以会生成test目录和test_helper.rb；而你执行rails generate rspec:install安装的是第三方测试框架RSpec，它会生成spec目录和对应的spec_helper.rb、rails_helper.rb——这俩是完全不同的测试体系，搞懂这点就不会乱了。

一、三个Helper文件的区别 #

1. test_helper.rb（Minitest专属） #

这是Minitest的核心配置文件，所有test目录下的测试文件都会自动引入它（就是你看到的每个测试类开头的require 'test_helper'）。

它的结构很简单：

• 先设置测试环境、加载Rails环境
• 定义ActiveSupport::TestCase类，所有Minitest测试类都继承自它
• 里面的parallelize、fixtures :all是Minitest的默认配置

你要加第三方gem的配置，直接写在这里就行，比如要加pundit-matchers，就在这个文件里加：

ENV['RAILS_ENV'] ||= 'test'
require_relative '../config/environment'
require 'rails/test_help'
# 先引入gem的文件
require "pundit/matchers"

class ActiveSupport::TestCase
  parallelize(workers: :number_of_processors)
  fixtures :all

  # 把pundit-matchers的方法引入所有测试类
  include Pundit::Matchers

  # 其他自定义helper方法写在这里...
end

2. spec_helper.rb（RSpec基础配置） #

这是RSpec的轻量配置文件，.rspec文件里默认加了--require spec_helper，所以所有spec文件都会自动加载它。它的定位是只放RSpec核心的、不依赖Rails的配置，比如断言语法、mock设置、随机执行顺序这些，目的是让测试启动更快。

3. rails_helper.rb（RSpec+Rails集成配置） #

这个文件会加载整个Rails环境（你看里面会有require File.expand_path('../config/environment', __dir__)），所以专门放和Rails相关的配置，比如数据库连接、fixtures加载、第三方gem（比如pundit-matchers）的Rails集成设置。

如果你用RSpec，要加pundit-matchers的配置，就在rails_helper.rb的RSpec配置块里加：

RSpec.configure do |config|
  # 已有的配置...
  config.include Pundit::Matchers
end

二、关于目录的困惑：test vs spec #

• test目录：是Rails官方默认的Minitest框架的测试目录，语法简洁、轻量，适合快速写测试，官方文档也主要围绕它。
• spec目录：是RSpec框架的测试目录，语法更具描述性（比如describe、context块），功能更丰富（比如自定义matchers、更灵活的测试组织），社区生态更活跃，很多第三方测试gem都是优先支持RSpec。

你不需要同时用两个目录，选一个就行：

• 如果你想继续用Rails默认的Minitest：完全不用管spec目录，所有测试写在test目录，配置都加在test_helper.rb里。
• 如果你想切换到RSpec：可以把test目录的测试迁移到spec目录（或者直接弃用test目录），所有新测试写在spec目录，用spec_helper和rails_helper做配置。

三、总结一下你的问题解决方案 #

1. 如果继续用Minitest（test目录）：
   直接在test_helper.rb里引入第三方gem并配置，比如pundit-matchers就按上面的例子加代码，之后所有测试类都能使用它的断言方法。

2. 如果切换到RSpec（spec目录）：
   把配置加在rails_helper.rb里，然后在spec目录下写符合RSpec语法的测试（比如用describe代替class ... < ActiveSupport::TestCase）。

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