Jekyll运行时出现segmentation fault段错误，如何诊断修复？

• Ruby环境与依赖版本不兼容：如果此前升级过Ruby大版本，或是使用系统自带的Ruby运行Jekyll项目，gem中编译的C扩展与当前Ruby运行时版本不匹配，就会触发内存访问异常，也就是段错误。出现Pathname常量重复初始化的警告，本质是冲突的依赖同时加载了Pathname模块的不同实现，是段错误的前置信号。
• 依赖包损坏：本地安装的gem包文件损坏、C扩展编译出错，会导致依赖加载时出现符号冲突，触发底层报错。
• Bundler版本不匹配：当前安装的Bundler版本和项目Gemfile.lock生成时使用的Bundler版本差异过大，会导致依赖加载顺序异常，出现重复加载、符号冲突的问题。
• 系统基础依赖缺失：编译Jekyll依赖所需的libffi、libxml2、Ruby开发库等系统包版本不对，会导致C扩展运行时调用系统接口出错，触发段错误。

• 先确认环境版本：分别执行ruby -v、bundle -v、gem list jekyll，核对输出的版本和项目Gemfile中标注的兼容版本范围是否匹配。
• 定位冲突依赖：执行RUBY_DEBUG=1 bundle exec jekyll serve --trace，查看段错误发生前最后加载的gem名称，即可定位到引发冲突的依赖包。
• 检查依赖完整性：执行bundle check验证已安装依赖是否和锁文件匹配，执行bundle doctor检测已安装gem的损坏、不兼容问题。

• 清理现有依赖：执行bundle clean --force删除项目本地安装的所有gem，再删除项目根目录下的Gemfile.lock锁文件。
• 对齐依赖版本：如果使用rbenv、rvm等Ruby版本管理工具，先切换到项目兼容的Ruby版本，再执行gem install bundler -v [项目原来使用的bundler版本号]安装对应版本的Bundler。
• 重新编译依赖：执行bundle install --redownload强制重新下载、编译所有依赖，消除之前损坏的编译产物残留。
• 替换Ruby环境：如果使用的是系统自带的Ruby，建议改用rbenv或rvm安装用户目录下的独立Ruby环境，Jekyll 3.x推荐使用Ruby 2.7版本，Jekyll 4.2+推荐使用Ruby 3.0~3.2版本，避免使用最新发布的Ruby大版本，减少兼容性问题。

内容的提问来源于stack exchange，提问作者Jan Černý