Ruby 3.0+使用C API时出现String#unpack方法未定义错误

Ruby 3.x 调整了嵌入式调用libruby的初始化逻辑，你当前使用的ruby_sysinit + ruby_init两步初始化是Ruby 2.7及更早版本的流程，3.x版本下缺失关键初始化步骤，导致核心方法未加载：

• Ruby 3.x 新增了builtin核心代码存储路径，位于Ruby标准库根目录下的3.x.0/builtin目录，包括String#unpack在内的一批核心方法的字节码实现存放在该目录下。你手动向$LOAD_PATH追加路径时遗漏了该目录，Ruby启动时无法加载这些核心方法定义。
• 手动拼接追加$LOAD_PATH的方式不符合Ruby 3.x初始化规范。3.x要求嵌入式场景必须在ruby_init执行后调用ruby_init_loadpath()函数，该函数会按正确优先级自动配置所有必须的加载路径（含builtin目录、标准库目录、架构相关扩展目录）。手动追加路径很容易出现路径遗漏、优先级错误问题，这也是Zlib这类C扩展可正常加载，但字节码实现的核心方法加载失败的原因。

命令行执行ruby指令可正常运行unpack，是因为ruby可执行文件自带完整初始化流程，和嵌入式调用libruby的流程不一致，问题和编译环节、操作系统无关，这也和跨Windows、Ubuntu平台复现同一问题的特征吻合。

二选一即可：

方案1：修正初始化流程（推荐） #

将初始化流程调整为以下顺序：

1. 调用ruby_sysinit完成系统层参数初始化，无命令行参数时传空argc/argv即可
2. 调用ruby_init完成Ruby VM基础初始化
3. 新增调用ruby_init_loadpath()，自动完成所有内置加载路径的配置，无需再手动追加Ruby自带的库路径
4. 如需加载自定义第三方扩展，可在该步骤之后再手动追加自定义路径
   调整后String#unpack及其他未加载的核心方法均可正常调用。

方案2：直接调用原生C API绕开方法查找 #

如果不需要走Ruby层方法派发逻辑，可直接调用Ruby C API暴露的原生unpack接口，完全不依赖Ruby层的方法定义：

// 接口原型，头文件中已定义，可直接调用
VALUE rb_str_unpack(VALUE str, VALUE format);

该接口行为和Ruby层String#unpack完全一致，传入字符串实例、格式字符串参数，返回解包后的数组，兼容Ruby 1.9到3.x全版本，不会因版本初始化逻辑变更出现调用失败问题。

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