运行Jekyll搭建Github Pages本地实例时，bundle exec报错找不到已安装的webrick

排查与解决步骤 #

• 在项目Gemfile中显式声明webrick依赖
  Ruby 3.0+不再默认自带webrick，而Github Pages的默认Gemfile通常不会包含该依赖。直接在项目根目录的Gemfile中添加一行：

  gem 'webrick'
  

  执行bundle install重新安装依赖，确保bundler能识别并关联该gem。

• 通过bundler启动Jekyll
  避免直接使用全局环境的jekyll serve，改用bundler指定项目本地gem环境执行：

  bundle exec jekyll serve
  

  这能规避系统全局gem与项目本地gem的环境冲突问题。

• 校验gem环境一致性
  执行gem env查看当前gem安装路径，对比你截图中的webrick路径，确认是否与bundler使用的路径匹配。若路径不一致，需切换到对应Ruby版本：

  # 若使用rbenv
  rbenv local <你的Ruby版本号>
  # 若使用rvm
  rvm use <你的Ruby版本号>
  

  切换后重新执行bundle install和bundle exec jekyll serve。

• 清理bundler缓存
  缓存异常可能导致依赖识别错误，执行以下命令清理后重新安装：

  bundle clean --force
  bundle install
  

终极尝试 #

若以上步骤均无效，可删除项目根目录的Gemfile.lock文件，再执行bundle install让bundler重新生成依赖锁文件，确保所有依赖的版本与路径完全匹配。

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