Windows安装Rails遇pacman公钥环缺失及sqlite3编译失败问题

问题本质 #

你遇到的报错包含两个核心原因：

• msys2的pacman密钥库未正确初始化、且运行时权限不足，导致无法从软件源下载依赖包
• 已安装的sqlite3仅为命令行运行版本，缺少编译sqlite3 rubygem所需的头文件、开发库文件

操作步骤（新手友好，按顺序执行） #

1. 修复pacman权限与密钥问题 #

必须使用管理员权限打开mingw64 shell，依次执行以下命令：

• 初始化密钥库：pacman-key --init
• 导入msys2官方默认密钥：pacman-key --populate msys2
• 升级密钥环组件：pacman -Syu msys2-keyring --noconfirm
• 全量更新msys2软件包：pacman -Syu --noconfirm

若执行过程中提示需要重启终端，请关闭当前mingw64 shell，重新用管理员权限打开后继续执行剩余命令。

2. 安装sqlite3开发依赖包 #

仍在管理员权限的mingw64 shell中执行命令：
pacman -S mingw-w64-x86_64-sqlite3 --noconfirm
执行完成后，编译所需的sqlite3.h头文件、对应库文件就会安装到系统路径中。

3. 重新安装sqlite3 gem #

打开你日常使用的Ruby命令行终端（CMD、PowerShell或Ruby专属终端均可），执行命令：
gem install sqlite3 -v '1.4.2'
安装成功后，再执行Rails安装命令即可：gem install rails

快速绕过方案（无需配置msys2） #

如果上述步骤仍无法解决问题，可以直接安装Windows平台预编译版本的sqlite3 gem，跳过本地编译环节，直接在Ruby终端执行：
gem install sqlite3 -v '1.4.2' --platform x64-mingw32

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