执行bundle exec jekyll serve报错，求排查Gemfile配置问题

错误信息 #

Could not find gem 'github-pages' in locally installed gems.
Run bundle install to install missing gems.

我的Gemfile内容 #

source "https://rubygems.org"

gem "github-pages", group: :jekyll_plugins

gem "tzinfo-data"
gem "wdm", "~> 0.1.0" if Gem.win_platform?

# If you have any plugins, put them here!
group :jekyll_plugins do
  gem "jekyll-paginate"
  gem "jekyll-sitemap"
  gem "jekyll-gist"
  gem "jekyll-feed"
  gem "jemoji"
  gem "jekyll-include-cache"
  gem "jekyll-algolia"
  gem "minimal-mistakes-jekyll"
end

配置问题及解决办法 #

当前错误直接解决步骤 #

先执行bundle install命令，安装Gemfile里声明的所有依赖包，包括缺失的github-pages gem。

Gemfile配置优化点 #

1. 重复插件引发冲突：github-pages已经内置了jekyll-paginate、jekyll-sitemap、jekyll-gist、jekyll-feed、jemoji、jekyll-include-cache这些插件，你在:jekyll_plugins组里重复添加会导致版本冲突，建议移除这些重复项。
2. 主题放置位置错误：minimal-mistakes-jekyll是Jekyll主题，不属于插件范畴，不需要放在:jekyll_plugins组里，单独声明即可。

修改后的Gemfile示例 #

source "https://rubygems.org"

gem "github-pages", group: :jekyll_plugins
gem "minimal-mistakes-jekyll"

gem "tzinfo-data"
gem "wdm", "~> 0.1.0" if Gem.win_platform?

group :jekyll_plugins do
  gem "jekyll-algolia" # 该插件不在github-pages内置列表中，需保留
end

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