FreeBSD 14.0部署Ruby on Rails遇sqlite3 gem安装失败求助

• 先确保系统安装必要依赖
  执行以下命令安装系统级sqlite3和pkg-config工具，这是gem正确识别sqlite3库的基础：

  pkg install sqlite3 pkgconf
  

• 强制gem使用系统sqlite3库创建项目
  临时指定系统pkgconfig配置文件路径，让gem调用系统已安装的sqlite3而非尝试编译自带版本，直接执行：

  PKG_CONFIG_PATH=/usr/local/lib/pkgconfig rails new truck
  

• 备选方案：手动安装sqlite3 gem并指定系统库路径
  如果上述命令仍失败，先清理已安装的sqlite3 gem残留，再手动指定系统库路径重新安装：

  gem uninstall sqlite3
  gem install sqlite3 -- --with-sqlite3-lib=/usr/local/lib --with-sqlite3-include=/usr/local/include
  

  完成后再执行rails new truck即可。

• 兜底方案：使用FreeBSD官方pkg安装Rails套件
  若不想手动处理依赖冲突，直接通过pkg安装完整Rails套件，系统会自动处理所有依赖项：

  pkg install rubygem-rails
  

  安装完成后再创建新项目即可。

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