页面构建失败:缺少子模块
如果 GitHub 页面代码包含对不存在或尚未正常初始化的子模块的引用,GitHub 页面站点将无法构建。
如果 GitHub 页面 站点因子模块缺少或未正常初始化而构建失败,将会收到一封如下的电子邮件:
主题:页面构建失败
页面构建因以下错误而失败:
“子模块
EXAMPLE_SUBMODULE
未使用.gitmodules
文件正常初始化。
只有在 Enterprise 实例上启用了出站电子邮件支持时,您才会收到电子邮件。有关详细信息,请联系您的站点管理员。
子模块不存在错误故障排除
提示:我们强烈建议本地运行 Jekyll,以便在推送到 您的 GitHub Enterprise Server 实例 之前能够轻松调试和修复构建错误。要详细了解故障排除选项,请参阅“GitHub Pages 构建故障排除。”
如果尚未初始化您的子模块,您需要通过以下步骤初始化:
- 在子模块的目录中,运行
git submodule init
,然后运行git submodule update
。 - 提交并推送更改以在服务器上触发另一次构建。