Guard与RSpec配置异常：仅提示运行但未执行测试

我之前也碰到过几乎一模一样的情况！Guard明明显示在监听目录，但不管怎么修改文件都不触发测试，直接跑bundle exec rspec却完全正常。结合你的情况，咱们一步步排查和修复：

1. 先检查Guardfile的核心配置 #

Guard不会默认识别你的测试文件位置，必须通过watch规则明确指定。如果规则没覆盖到文件变化，自然不会触发测试。

先把Guardfile简化成最基础的版本试错：

# 基础Guardfile配置，先排除复杂规则干扰
guard :rspec, cmd: 'bundle exec rspec' do
  # 直接监听所有spec测试文件
  watch(%r{^spec/.+_spec\.rb$})
  # 监听源码文件，映射到对应测试文件（若源码在app目录）
  watch(%r{^app/(.+)\.rb$}) { |match| "spec/#{match[1]}_spec.rb" }
  # 修改spec_helper时重新跑所有测试
  watch('spec/spec_helper.rb') { 'spec' }
end

如果你的源码在lib目录而非app，记得把第二条规则里的app改成lib。保存后重启Guard，修改一个spec文件，看是否触发测试。

2. 强制启用Polling模式（针对容器/虚拟机环境） #

从你的输出里的test_1 |来看，你大概率是在Docker或虚拟机里运行Guard。这类环境下，Guard默认的文件系统事件监听（如inotify、fsevent）可能无法正常捕获文件变化，需要强制用轮询模式：

临时测试方式： #

运行Guard时加参数：

bundle exec guard -d --force-polling

如果这样能触发测试，就把配置写到Guardfile里永久生效：

# 放在Guardfile最顶部
Guard.setup force_polling: true

# 后续再写rspec的guard配置
guard :rspec, cmd: 'bundle exec rspec' do
  # ...你的watch规则
end

3. 检查RSpec配置是否有全局过滤 #

打开你的spec_helper.rb，排查是否存在全局测试过滤规则，比如：

RSpec.configure do |config|
  # 这类规则会跳过所有未标记的测试
  config.filter_run focus: true
  config.run_all_when_everything_filtered = false
  # 或者直接跳过所有测试
  config.filter_run_excluding skip: true
end

如果有这类配置，要么注释掉，要么确保你的测试没有被过滤掉。

4. 分析Guard调试输出的细节 #

运行bundle exec guard -d后，修改一个spec文件，仔细看调试输出：

• 如果看不到Detected change in ...的日志：说明Guard根本没捕获到文件变化，回到步骤2确认polling模式。
• 如果看到了文件变化，但没有Running: bundle exec rspec ...的命令：说明Guard的RSpec插件配置有误，检查Guardfile里的cmd参数是否正确，或尝试更新guard-rspec gem。
• 如果看到了执行命令，但没有测试输出：直接复制那个命令在终端里运行，排查是否有路径错误、测试文件为空等问题。

5. 检查Gem版本兼容性 #

确保guard-rspec的版本和你的rspec-core版本兼容：

• RSpec 3.x 需要 guard-rspec >= 2.1.0
• RSpec 4.x 需要 guard-rspec >= 4.0.0

你可以在Gemfile里指定兼容版本：

gem 'guard-rspec', '~> 4.7' # 适配RSpec 4.x
# 或者
gem 'guard-rspec', '~> 2.1' # 适配RSpec 3.x

然后运行bundle update guard-rspec更新。

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