Rails项目搭建报错：无法找到指定rails gem及bundle install异常求助

1. 确认MSYS2与Ruby环境的关联 #

• 打开MSYS2终端（请勿使用Windows默认命令行/PowerShell），执行 ridk version 验证Ruby与MSYS2的集成状态
• 执行 echo $PATH 检查环境变量，确认包含Ruby安装目录下的bin路径（如C:\RubyXX-x64\bin）
• 若未安装完整开发工具链，在MSYS2终端执行以下命令补装：

  pacman -S base-devel mingw-w64-x86_64-toolchain
  

2. 修复Gem源与依赖缓存 #

• 删除项目目录下的Gemfile.lock文件，清除旧依赖缓存
• 在MSYS2终端执行 gem update --system 更新Gem系统
• 更换国内Gem源以规避网络问题：

  gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
  

• 回到项目目录重新执行 bundle install，观察编译类错误提示

3. 匹配Rails版本与项目依赖 #

• 执行 gem list rails 查看本地已安装的Rails版本，确认是否包含项目Gemfile要求的~>7.0.3, >=7.0.3.1版本
• 若本地无对应版本，直接执行 gem install rails -v 7.0.3.1 强制安装指定版本
• 安装完成后再次执行 bundle install

4. 确保终端环境一致性 #

• 全程使用MSYS2终端操作，避免混用其他终端导致环境变量不兼容
• 执行 ridk enable 手动激活Ruby的MSYS2集成环境后再运行命令

常见编译错误处理 #

若bundle install出现missing xxx.h类错误，说明MSYS2缺少对应依赖库，按需执行：

• 安装sqlite3依赖：pacman -S mingw-w64-x86_64-sqlite3
• 安装Node.js（Rails 7必需）：pacman -S mingw-w64-x86_64-nodejs

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