Jekyll+GitHub Pages使用Bundler遇未解析规格问题求助

作为同样从移动端跨到静态博客搭建、折腾过老Jekyll主题的开发者，我完全懂你这种对着一堆Ruby命令懵圈的感觉！针对你遇到的Unresolved Specs问题，咱们一步步来排查解决：

1. 先清理本地Bundler缓存 #

老主题的依赖版本通常比较旧，本地缓存的依赖包很可能和主题需要的版本冲突。先执行这条命令清空缓存：

bundle clean --force

2. 确保Gemfile适配GitHub Pages规范 #

GitHub Pages有自己固定的Jekyll及插件版本集，老主题很可能没适配最新的规范。打开你本地仓库的Gemfile，检查是否有这行配置：

gem "github-pages", group: :jekyll_plugins

如果没有，直接添加进去；如果已经有，执行这条命令更新到GitHub Pages官方支持的版本：

bundle update github-pages

3. 重新安装依赖 #

缓存清理+配置更新后，重新执行安装命令，指定依赖安装到本地目录（避免全局依赖冲突）：

bundle install --path vendor/bundle

4. 检查Ruby版本兼容性 #

老Jekyll主题对Ruby版本有严格要求，比如Jekyll 3.x需要Ruby 2.5及以上，Jekyll 4.x需要Ruby 2.6及以上。你可以通过以下命令查看当前Ruby版本：

ruby -v

如果版本不匹配，推荐用rbenv或者rvm切换到主题要求的Ruby版本（一般主题的README或Gemfile里会标注），然后再重新执行bundle install。

5. 锁定主题依赖版本（终极方案） #

如果上面的步骤都没用，大概率是主题的某个依赖和GitHub Pages的版本不兼容。你可以找到主题原仓库的Gemfile.lock文件，把里面的依赖版本逐一复制到你的Gemfile里指定版本，比如：

gem "jekyll", "3.9.2"
gem "jekyll-paginate", "1.1.0"

然后再执行bundle install强制安装指定版本。

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