我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们
文章版本: GitHub.com

GitHub Pages 构建故障排除

GitHub 页面 可用于具有 GitHub Free 的公共仓库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。更多信息请参阅“GitHub 的产品。”

如果 GitHub Pages 站点无法在我们的服务器上构建或遇到其他错误,您可以通过查看常见问题或特定错误消息对构建错误进行故障排除。 您还可以通过电子邮件、在仓库中、在命令行中或使用第三方服务查看 Jekyll 构建错误消息。

查看 Jekyll 构建错误消息

您可以通过电子邮件、在仓库中、在命令行中或通过每次提交后显示错误消息的第三方服务查看 Jekyll 构建错误消息。

一般 Jekyll 构建失败

一般构建失败不会生成包含特定文件和错误信息的电子邮件。 如果您收到的电子邮件只是说“页面构建失败”而没有进一步的详细信息,或者您的 GitHub Pages 站点在第一次推送后没有显示,请检查这些常见错误。

“页面构建失败:缺少文档文件夹”

如果您启用了 master 分支 /docs 文件夹 来源设置,并且包含站点源文件的 /docs 文件夹从 master 分支上的仓库根目录删除,则 GitHub 页面站点无法构建。

“页面构建失败:子模块无效”

如果 GitHub 页面包含对无效子模块的引用,GitHub 页面站点将无法构建。

“页面构建失败:缺少子模块”

如果 GitHub 页面代码包含对不存在或尚未正常初始化的子模块的引用,GitHub 页面站点将无法构建。

“页面构建失败:Markdown 错误”

如果 GitHub 页面代码包含 Markdown 错误,GitHub 页面站点将无法构建。

“页面构建失败:配置文件错误”

如果 GitHub 页面仓库中的 _config.yml 文件有语法错误,将无法构建 GitHub 页面站点。

“页面构建失败:未知标记错误”

如果 GitHub 页面代码无法识别的 Liquid 标记,GitHub 页面站点将无法构建。

“页面构建失败:标记未正确终止”

如果 GitHub 页面代码包含未正确结束的 Liquid 输出标记,GitHub 页面站点将无法构建。

“页面构建失败:标记未正确关闭”

如果 GitHub 页面代码包含未正确结束的 Liquid 逻辑标记,GitHub 页面站点将无法构建。

“页面构建失败:包含目录中不存在文件”

如果 GitHub 页面代码引用 _includes 目录中不存在的文件,GitHub 页面站点将无法构建。

“页面构建失败:文件是符号链接”

如果 GitHub 页面仓库中的文件引用仓库中不存在的符号链接文件,则 GitHub 页面站点无法构建。

“页面构建失败:站点仓库中不存在符号链接”

如果 GitHub 页面站点包含站点仓库中不存在的另一个文件或目录的 符号链接(也称为 symlink),站点将无法构建。

“页面构建失败:文件未正确进行 UTF-8 编码”

如果 GitHub 页面仓库包含未正确进行 UTF-8 编码的文件,GitHub 页面站点将无法构建。

“页面构建失败:发布日期无效”

如果 GitHub 页面仓库包含的发布帖子显示无效的日期时间,GitHub 页面站点将无法构建。

“页面构建失败:Sass 或 SCSS 无效”

如果 GitHub 页面仓库包含具有无效内容的 Sass 或 SCSS 文件,GitHub 页面站点将无法构建。

“页面构建失败:高亮插件语言无效”

如果 GitHub 页面代码使用包含无效语言标识符的 highlighter 标记,GitHub 页面站点将无法构建。

将 Markdown 处理器更新为 kramdown

如果您尚未使用 kramdown(Jekyll 3.0.0 的默认 Markdown 处理器),则必须在 _config.yml 文件中更新 Markdown 处理器。

“页面构建失败:已配置相对永久链接”

如果您在 _config.yml 文件中设置了相对永久链接,应会收到页面构建失败的消息,建议您从 _config.yml 文件删除 relative_permalink 选项,并将站点中的任何相对永久链接替换为绝对永久链接。

“页面构建失败:'for' 循环中存在语法错误”

如果 GitHub 页面 代码在 Liquid for 循环声明中包含无效的语法,GitHub 页面 站点将无法构建。

没有看到以下划线开头的文件

如果您的 GitHub Pages 站点没有发布某些文件,您可能需要重新格式化这些文件的标题。 如果使用 Jekyll,您可以创建 .nojekyll 文件或编辑 _config.yml 文件以发布这些文件。

“页面构建失败:数据文件中的 YAML 无效”

如果 GitHub 页面站点的 _data 文件夹中的一个或多个文件包含无效的 YAML,GitHub 页面将无法构建。

“页面构建失败:日期不是有效的日期时间”

如果 GitHub 页面仓库包含的页面显示无效的日期时间,GitHub 页面站点将无法构建。

问问别人

找不到要找的内容?

联系我们