Windows环境下Rails应用安装sqlite3 gem失败求助

我之前在Windows上部署Rails项目时也碰到过一模一样的sqlite3 gem安装坑，尤其是1.4.0这个版本，给你几个亲测有效的解决步骤：

1. 确保MSYS2编译环境配置正确 #

Windows下编译Ruby gem依赖MSYS2的MinGW64环境，之前的问题大概率是环境没配置全：

• 打开MinGW64终端（注意不是MSYS终端，要选带MinGW64标识的那个），执行以下命令安装核心依赖包：

  pacman -S mingw-w64-x86_64-sqlite3 mingw-w64-x86_64-gcc mingw-w64-x86_64-make
  

  这三个包缺一不可：sqlite3提供编译所需的库和头文件，gcc是编译工具，make负责构建流程，少一个都可能触发编译失败。
• 如果你是用RubyInstaller安装的Ruby，先在命令提示符里运行ridk enable，这个命令会自动配置好MSYS2的环境变量，避免路径识别错误。

2. 手动指定sqlite3路径编译安装 #

直接通过gem命令强制指定头文件和库的路径，绕过自动检测的bug，执行这条命令（注意替换成你的MSYS2实际安装路径）：

gem install sqlite3 -v '1.4.0' -- --with-sqlite3-lib=C:/msys64/mingw64/lib --with-sqlite3-include=C:/msys64/mingw64/include

如果你的MSYS2装在D盘，就把路径改成D:/msys64/mingw64/...，确保路径里没有空格，否则可能会触发路径解析错误。

3. 清理无效缓存和旧安装残留 #

之前的失败尝试可能留下了损坏的缓存文件，先清理干净再重新安装：

gem uninstall sqlite3
gem cleanup sqlite3

注意你之前用的gem unlink sqlite是无效的，RubyGem没有这个命令，正确的卸载方式是gem uninstall。

4. 避开常见误区 #

• --universal参数是旧版本RubyGem的废弃参数，现在已经不再支持，所以这个命令肯定无效；
• 确保你的Ruby版本和sqlite3 1.4.0兼容：该版本要求Ruby 2.3及以上版本，如果你用的是更老的Ruby，建议升级Ruby或者降低sqlite3版本（比如指定1.3.13版本尝试）；
• 不要用Windows默认的命令提示符执行编译命令，尽量用RubyInstaller自带的命令提示符或者MinGW64终端，环境变量配置更完善。

如果按照上面的步骤操作，应该能解决sqlite3.h缺失和dlopen相关的编译错误，成功安装sqlite3 1.4.0 gem。

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