Windows 10下无法安装mysql2 gem的问题求助

问题重现 #

已安装MySQL 8.0.30和Ruby v3.0.4，可正常使用MySQL，但执行以下命令安装mysql2 gem时失败：

gem install mysql2 -v '0.5.4' -- '--with-mysql-lib="C:\Program Files\MySQL\MySQL Server 8.0\lib" --withmysql-include="C:\Program Files\MySQL\MySQL Server 8.0\include"'

错误提示：

ERROR:  Error installing mysql2:
        ERROR: Failed to build gem native extension.

checking for rb_absint_size()... yes
checking for rb_absint_singlebit_p()... yes
checking for rb_wait_for_single_fd()... yes
checking for rb_enc_interned_str() in ruby.h... yes
checking for -lmysqlclient... no
-----
mysql client is missing. Check your installation of MySQL or Connector/C, and try again.
-----
*** extconf.rb failed ***

解决方法 #

• 修正命令参数错误
  原命令中--withmysql-include缺少横杠，应为--with-mysql-include，同时调整引号格式避免Windows下的转义问题，修正后的命令：

  gem install mysql2 -v '0.5.4' -- --with-mysql-lib="C:\Program Files\MySQL\MySQL Server 8.0\lib" --with-mysql-include="C:\Program Files\MySQL\MySQL Server 8.0\include"
  

• 确认MySQL开发组件已安装
  运行MySQL安装程序，检查是否勾选了「开发组件（Developer Components）」选项。如果未安装，重新运行安装程序选择该组件，确保include目录的头文件和lib目录的库文件完整。

• 匹配Ruby与MySQL的架构
  确保Ruby和MySQL的架构一致：64位Ruby对应64位MySQL，32位Ruby对应32位MySQL，架构不兼容会导致无法识别库文件。

• 配置系统环境变量
  将MySQL的bin目录（C:\Program Files\MySQL\MySQL Server 8.0\bin）添加到系统PATH环境变量中，重启命令行窗口后再尝试安装。

• 使用MySQL Connector/C替代
  若MySQL自带库仍无法识别，下载与MySQL 8.0.30匹配的MySQL Connector/C，安装后指定其路径：

  gem install mysql2 -v '0.5.4' -- --with-mysql-lib="C:\Program Files\MySQL\Connector C 8.0\lib" --with-mysql-include="C:\Program Files\MySQL\Connector C 8.0\include"
  

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