为什么Rspec无法找到select2方法？同事无需配置可正常使用

1. Gem版本与自动混入规则差异 #

capybara-select-2不同版本的默认行为存在区别：

• v1.x版本会自动向RSpec上下文混入select2方法，无需手动添加include配置
• v2.x及以上版本关闭了自动混入逻辑，必须手动声明config.include CapybaraSelect2才能使用对应方法
  你和同事本地安装的gem版本不一致是最可能导致差异的原因，可分别执行bundle list | grep capybara-select-2确认版本号。

2. Gem加载环境配置差异 #

• 先检查Gemfile中capybara-select-2的分组：如果该gem仅声明在group :test块中，需要确认Heroku运行测试时的环境配置：
  • 测试启动命令是否指定了RAILS_ENV=test
  • Heroku环境变量BUNDLE_WITHOUT是否包含test，如果配置了该参数会跳过安装test组的gem，直接触发常量未定义报错
• 你本地可能存在全局安装capybara-select-2的情况，即使项目依赖未正确配置也能加载到对应常量，但Heroku的依赖完全基于Gemfile.lock安装，就会出现本地正常线上报错的差异。

3. 配置文件加载顺序差异 #

很多RSpec项目会同时存在spec_helper.rb和rails_helper.rb两个配置文件：

• 若你的同事已经在rails_helper.rb中提前添加了CapybaraSelect2的include配置，自然不需要额外修改
• 如果你仅在spec_helper.rb中添加了配置，而Heroku运行测试时默认加载rails_helper.rb未触发你新增的配置，也会出现对应报错。

1. 对齐所有环境的gem版本：在Gemfile中指定capybara-select-2的固定版本，执行bundle update capybara-select-2更新Gemfile.lock后提交到代码库
2. 将config.include CapybaraSelect2配置移到rails_helper.rb的RSpec.configure块内部，确保加载时机正确
3. 调整Heroku测试配置：移除BUNDLE_WITHOUT中的test参数，测试启动命令统一使用RAILS_ENV=test bundle exec rspec

内容的提问来源于stack exchange，提问作者raphael-allard