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

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

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

如果 GitHub 页面 站点因编码错误而构建失败,将会收到一封如下的电子邮件:

主题:页面构建失败

页面构建因以下错误而失败:

文件 example.html 未正确进行 UTF-8 编码。

UTF-8 编码错误疑难排解

提示:我们强烈建议本地运行 Jekyll,以便在推送到 GitHub 之前能够轻松调试和修复构建错误。要详细了解故障排除选项,请参阅“GitHub Pages 构建故障排除。”

计算机预期文本显示为拉丁字符。 使用非拉丁字符(如 日本語)而未告知计算机预期这些字符时,就会发生编码错误。

要强制 UTF-8 编码,请在 _config.yml 文件中添加以下行: encoding: UTF-8

在进行此更改后,您需要提交更改并推送到 GitHub 上的页面仓库,以在服务器上触发另一次构建。

如需 Jekyll 配置的更多帮助,请参阅 Jekyll 文档

问问别人

找不到要找的内容?

联系我们