1. 确保Ruby与Msys2工具链完全兼容 #

• 必须使用RubyInstaller安装Ruby（避免其他渠道的Ruby版本），安装时勾选：
  • "Add Ruby executables to your PATH"
  • "MSYS2 development toolchain"
• 打开命令提示符，执行ridk enable激活Ruby关联的Msys2环境，后续所有操作都在该环境下执行，不要直接打开独立的Msys2 shell。

2. 重新安装依赖库并配置pkg-config路径 #

• 在激活的ridk环境中，执行命令安装ICU和pkg-config：

  pacman -S mingw-w64-x86_64-icu mingw-w64-x86_64-pkg-config
  

• 设置pkg-config环境变量，确保能识别ICU的配置文件：

  export PKG_CONFIG_PATH=/mingw64/lib/pkgconfig
  

3. 带编译参数安装github-linguist #

• 执行gem安装命令时，手动指定ICU路径和编译宏，解决数据类型冲突问题：

  gem install github-linguist -- --with-icu-dir=/mingw64 --with-cflags="-D_UINT32_T_DEFINED"
  

  其中-D_UINT32_T_DEFINED用于规避Windows系统头文件与ICU头文件的uint32_t定义冲突，解决静态断言失败的编译错误。

4. 验证安装结果 #

• 安装完成后，执行以下命令确认成功：

  ruby -r linguist -e "puts Linguist::VERSION"
  

  若能输出版本号，说明安装正常。

常见问题排查 #

• 如果安装仍失败，先清理gem缓存再重试：

  gem cleanup github-linguist
  

• 全程使用ridk enable激活的环境，不要混用Windows CMD、PowerShell或独立Msys2 shell。

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