在CentOS 7上编译Ruby 3.2出现错误的原因是什么？

问题重现 #

使用rbenv的ruby-build插件编译Ruby 3.2时出现以下编译错误，同一机器编译Ruby 3.1无异常：

compiling bignum.c
In file included from vm_core.h:164:0,
                 from iseq.h:14,
                 from mini_builtin.c:3,
                 from miniinit.c:51:
thread_pthread.h:109:39: error: expected ‘=’, ‘,’, ‘;’, ‘asm’ or ‘__attribute__’ before ‘struct’
 RUBY_EXTERN RB_THREAD_LOCAL_SPECIFIER struct rb_execution_context_struct *ruby_current_ec;
                                       ^
In file included from iseq.h:14:0,
                 from mini_builtin.c:3,
                 from miniinit.c:51:
vm_core.h: In function ‘rb_current_execution_context’:
vm_core.h:1864:34: error: ‘ruby_current_ec’ undeclared (first use in this function)
     rb_execution_context_t *ec = ruby_current_ec;
                                  ^
vm_core.h:1864:34: note: each undeclared identifier is reported only once for each function it appears in

可能原因及解决方案 #

1. 编译器版本不兼容 #

Ruby 3.2对编译器版本要求更高（官方要求GCC 8.1+ / Clang 6.0+），旧版编译器无法正确解析RB_THREAD_LOCAL_SPECIFIER宏，导致语法错误。

解决步骤：

• 检查当前编译器版本：

  gcc --version
  

• 升级编译器：
  • Debian/Ubuntu系统：

    sudo apt install gcc-10 g++-10
    export CC=gcc-10 CXX=g++-10
    

  • RHEL/CentOS系统：

    sudo yum install gcc-toolset-10
    scl enable gcc-toolset-10 bash
    

• 重新执行Ruby编译命令。

2. 缺失线程相关依赖包 #

系统缺少pthread线程库的开发头文件，导致编译时无法正确识别线程本地存储相关定义。

解决步骤：

• Debian/Ubuntu系统：

  sudo apt install build-essential libssl-dev libreadline-dev zlib1g-dev libpthread-stubs0-dev
  

• RHEL/CentOS系统：

  sudo yum groupinstall "Development Tools"
  sudo yum install openssl-devel readline-devel zlib-devel glibc-devel
  

• 清理之前的编译缓存后重新编译：

  rbenv uninstall 3.2.x # 替换为你要安装的具体版本号
  rbenv install 3.2.x
  

3. ruby-build插件版本过旧 #

旧版ruby-build未适配Ruby 3.2的编译参数，传递了错误的编译选项导致失败。

解决步骤：

• 如果是通过Git安装的ruby-build：

  cd ~/.rbenv/plugins/ruby-build
  git pull
  

• 如果是通过包管理器安装：

  # Debian/Ubuntu
  sudo apt update && sudo apt upgrade ruby-build
  # RHEL/CentOS（若通过yum安装）
  sudo yum update ruby-build
  

• 重新尝试编译Ruby 3.2。

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