运行含Capybara与Selenium的Ruby文件遇报错，求助解决

让我们一步步搞定你遇到的这两个问题：

一、解决 cannot load such file -- capybara (LoadError) 错误 #

这个错误的核心是你的Ruby环境里还没安装Capybara，或者项目没有正确引入它：

• 先确认Capybara是否已安装：在终端执行 gem list capybara，如果输出里没有Capybara，先安装它：

  gem install capybara
  

• 如果你用Bundler管理项目依赖（有Gemfile），更推荐把Capybara添加到Gemfile中：

  gem 'capybara'
  gem 'selenium-webdriver' # 你的项目本来就用Selenium，记得加上这个
  

  然后执行 bundle install，这样项目的依赖会更稳定，避免版本冲突。
• 最后检查你的Ruby测试文件里是否正确引入了Capybara：

  require 'capybara'
  require 'capybara/cucumber' # 如果是用Cucumber的话，需要加这个
  

二、解决 gem install poltergeist 的 ArgumentError 错误 #

你遇到的参数错误，大多是Ruby版本与Poltergeist版本不兼容，或者旧版Rubygems的问题，试试这些方案：

1. 指定兼容的Poltergeist版本
   Poltergeist的新版本对Ruby版本要求较高（比如v2.0+需要Ruby 2.6+），如果你的Ruby版本偏旧（比如2.5及以下），安装旧版本即可：

   gem install poltergeist -v 1.18.1
   

   这个版本支持Ruby 2.3及以上，兼容性更好。

2. 升级Rubygems
   旧版Rubygems处理某些gem的依赖时可能会出现参数错误，先升级Rubygems：

   gem update --system
   

   升级完成后再尝试安装Poltergeist。

3. 用Bundler安装（更推荐）
   在Gemfile中添加Poltergeist，Bundler会自动帮你匹配兼容的版本：

   gem 'poltergeist'
   

   然后执行 bundle install 即可。

4. 替代方案：换用Headless Chrome/Firefox
   其实Poltergeist依赖的PhantomJS已经停止维护了，现在更推荐用Headless Chrome或Firefox作为Capybara的驱动，稳定性更好：

   • 确保安装了selenium-webdriver（前面已经加在Gemfile里了）
   • 配置Capybara使用Headless Chrome：

     Capybara.register_driver :headless_chrome do |app|
       capabilities = Selenium::WebDriver::Remote::Capabilities.chrome(
         'goog:chromeOptions' => { args: %w[headless disable-gpu window-size=1920,1080] }
       )
       Capybara::Selenium::Driver.new(app, browser: :chrome, capabilities: capabilities)
     end
     Capybara.default_driver = :headless_chrome
     

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