如何从源码编译原生Ruby gem m_t_parser 构建可用版本

前置环境确认 #

• 必须使用对应Ruby版本的MSYS2 Devkit终端执行操作（可从Windows开始菜单的Ruby安装目录下找到Start Command Prompt with Ruby或MSYS2 MinGW 64-bit快捷方式启动，普通CMD/PowerShell无完整编译工具链）
• 提前修复extconf.rb遗留问题：将文件中所有未替换的CONFIG常量全部改为RbConfig::CONFIG，注释掉$INCFLAGS << " -I/usr/local/include"这一行（Windows无该路径）

已生成Makefile后的编译步骤 #

1. 切换到扩展源码目录：

cd C:\Ruby27-x64\lib\ruby\gems\2.7.0\gems\m_t_parser-1.1.7\ext\src

2. 执行编译命令：
   make
   编译完成后会在当前目录生成m_t_parser.so扩展文件
3. 执行安装命令，将扩展文件放到Ruby可识别的扩展目录：
   make install

Windows环境兼容性问题修复 #

编译报错大多来自原生代码的Linux依赖，可按以下方式解决：

• pthread依赖缺失：在MSYS2终端执行pacman -S mingw-w64-x86_64-libwinpthread-git安装Windows兼容的pthread库，安装完成后重新执行ruby extconf.rb生成新的Makefile即可通过依赖检查
• 代码级兼容问题：如果编译时报特定函数未定义，可根据报错信息修改C/C++源码：比如Linux下的sleep(秒)替换为Windows的Sleep(毫秒)，删除Linux特有的头文件引用（如unistd.h）替换为windows.h等，需根据具体报错逐一适配

全流程编译安装标准步骤（从源码包开始） #

如果需要从头走完整流程，可按以下操作：

1. 进入gem根目录：cd C:\Ruby27-x64\lib\ruby\gems\2.7.0\gems\m_t_parser-1.1.7
2. 执行扩展编译任务：rake compile（绝大多数带原生扩展的gem都预设了该任务，会自动执行extconf.rb生成Makefile、编译、安装全流程，无需手动操作）
3. 若需打包为本地gem安装包，执行：gem build m_t_parser.gemspec，生成的m_t_parser-1.1.7.gem文件可通过gem install --local m_t_parser-1.1.7.gem直接安装

安装验证 #

打开irb执行require 'm_t_parser'，无报错即为安装成功。

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