如何安装与Ruby 2.6.4及Rails 6.x兼容的Nokogiri版本

核心原因 #

Nokogiri从1.14版本开始要求Ruby版本 >=2.7，而你使用的Ruby 2.6.4不在兼容范围内；同时部分Rails 6.x版本默认依赖nokogiri ~>1.14，这就导致了安装时的版本冲突。

分步解决方法 #

1. 先安装兼容的Nokogiri版本
   直接安装支持Ruby 2.6.4的最高Nokogiri版本：

   gem install nokogiri -v 1.13.10
   

2. 安装Rails 6.x并跳过Nokogiri的依赖检查
   安装指定版本的Rails时，忽略nokogiri的自动依赖安装，避免它尝试拉取不兼容的1.14+版本：

   # 替换6.1.7.6为你需要的具体Rails 6.x版本
   gem install rails -v 6.1.7.6 --ignore-dependencies nokogiri
   

3. 在项目中锁定Nokogiri版本
   创建Rails项目后，打开Gemfile，添加或修改Nokogiri的版本锁定：

   gem 'nokogiri', '~> 1.13.10'
   

   然后执行bundle安装确保依赖生效：

   bundle install
   

注意事项 #

• 不要用系统包管理工具（比如apt）安装Nokogiri，系统版本和Ruby环境的gem依赖容易不匹配，会导致后续运行报错。
• 如果是已有项目，直接修改Gemfile中的Nokogiri版本为1.13.10，再执行bundle update nokogiri即可。

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