需先安装Ruby运行环境（推荐3.0+）、配置国内RubyGems源（如ruby.taobao.org）、安装capybara与selenium-webdriver gem、下载ChromeDriver，并创建capybara_setup.rb配置驱动、app_host及等待时间。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望在Ruby环境中使用Capybara进行Web自动化测试，则需要先完成Ruby运行环境的搭建以及相关依赖库的安装。以下是完成Capybara基础环境配置的具体步骤：

一、安装Ruby运行环境

Ruby是Capybara运行的前提，必须确保系统中已安装兼容版本的Ruby解释器，并能被命令行正确识别。

1、访问Ruby官方下载页面，选择与当前操作系统匹配的稳定版安装包（推荐Ruby 3.0及以上版本）。

2、Windows用户双击下载的.exe文件，勾选Add Ruby executables to your PATH选项后完成安装。

3、macOS用户可使用Homebrew执行命令：brew install ruby，并确认安装后输出的Ruby版本不低于3.0。

4、在终端或命令提示符中运行ruby -v和gem -v，验证Ruby与RubyGems是否正常可用。

二、配置RubyGems源以加速依赖安装

默认RubyGems源位于国外服务器，国内用户直连常出现超时或失败，需切换为国内镜像源以保障后续gem安装成功率。

1、执行命令查看当前源列表：gem sources -l。

2、移除原始源：gem sources --remove https://rubygems.org/。

3、添加清华镜像源：gem sources --add https://ruby.taobao.org/（注：taobao源已由清华接管并持续维护）。

4、再次运行gem sources -l，确认仅保留https://ruby.taobao.org/这一有效源。

三、安装Capybara及其核心驱动依赖

Capybara本身不直接执行浏览器操作，需配合Selenium WebDriver等驱动实现真实浏览器交互，因此需一并安装对应gem包。

1、运行命令安装Capybara主库：gem install capybara。

2、安装Selenium WebDriver支持：gem install selenium-webdriver。

3、若需使用Chrome浏览器进行测试，还需下载与Chrome版本匹配的ChromeDriver，并将其所在路径加入系统PATH环境变量。

4、验证安装结果：在Ruby脚本中执行require 'capybara'与require 'selenium/webdriver'，不报错即表示加载成功。

四、初始化Capybara测试配置文件

为使Capybara在项目中具备可复用性与可维护性，需在项目根目录下创建标准化配置文件，明确驱动类型、应用主机及等待策略等关键参数。

1、在项目目录中新建文件capybara_setup.rb。

2、写入基础配置代码：require 'capybara'。

3、设置默认驱动为Selenium Chrome：Capybara.default_driver = :selenium_chrome。

4、指定待测应用地址：Capybara.app_host = 'http://localhost:3000'（根据实际服务端口调整）。

5、启用自动等待机制：Capybara.default_max_wait_time = 5。