搭建Jekyll GitHub Pages时遇Gemfile不存在错误，求解决方法

核心原因 #

GitHub Pages构建Jekyll站点时，必须依赖根目录下的Gemfile和Gemfile.lock文件管理Ruby依赖，缺少这两个文件会直接触发构建失败。

具体修复步骤 #

1. 在仓库根目录创建Gemfile #

新建名为Gemfile的文件，填入以下内容（根据你使用的主题调整依赖）：

source "https://rubygems.org"

# 锁定GitHub Pages官方依赖版本，避免兼容性问题
gem "github-pages", group: :jekyll_plugins
gem "jekyll", "~> 3.9.3" # 对应GitHub Pages当前支持的Jekyll稳定版本

# 替换为你实际使用的主题依赖，比如用minima主题就写下面这行
gem "minima", "~> 2.5"

注：如果你的复刻主题仓库本身带有Gemfile模板，直接复用并调整内容即可，无需从零编写。

2. 生成Gemfile.lock（本地操作，推荐执行） #

如果本地装有Ruby环境，在仓库根目录运行以下命令：

bundle install

该命令会自动生成Gemfile.lock，锁定所有依赖的具体版本，保证本地调试和GitHub Pages构建环境的一致性。

3. 检查GitHub Pages基础配置 #

• 进入仓库的Settings > Pages，确认构建来源选择的是正确分支（比如main或gh-pages）。
• baseurl无需强制设为"/"，如果你的站点是根域名部署，留空或设为""即可，GitHub Pages会自动适配路径。

4. 调整自定义构建脚本（若使用GitHub Actions） #

如果你自定义了build-test的GitHub Actions流程，需在Setup-ruby步骤后添加依赖安装命令：

- name: Install dependencies
  run: bundle install

确保Actions先安装Gemfile中声明的依赖，再执行Jekyll构建操作。

验证修复 #

将Gemfile和Gemfile.lock提交到仓库，重新触发GitHub Pages构建。若仍失败，检查这两个文件是否确实在仓库根目录，且Gemfile中的主题依赖与你使用的主题完全匹配。

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