跳至主要内容

为您的 GitHub Pages 站点创建自定义 404 页面

当有人尝试访问您站点上不存在的页面时,您可以显示自定义的 404 错误页面。

谁可以使用此功能?

GitHub Pages 在公共仓库中可使用 GitHub Free 和组织的 GitHub Free;在公共和私有仓库中可使用 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server。欲了解更多信息,请参阅 GitHub 的套餐

  1. 在 GitHub 上,前往您站点的仓库。

  2. 为您的站点导航到发布源。欲了解更多信息,请参阅 配置 GitHub Pages 站点的发布源

  3. 在文件列表上方,选择 添加文件下拉菜单,然后点击 创建新文件

    或者,您可以点击在左侧的文件树视图中。

    Screenshot of the main page of a repository highlighting both the "Add file" and the "plus sign" icon, described above, with an orange outline.

  4. 在文件名字段中,输入 404.html404.md

  5. 如果您将文件命名为 404.md,请在文件开头添加以下 YAML 前置内容:

    ---
    permalink: /404.html
    ---
    
  6. 在 YAML 前置内容下面(如果有),添加您希望在 404 页面上显示的内容。

  7. 点击 提交更改...

  8. 在“Commit message”字段中,键入简短且有意义的提交信息,描述您对文件所做的更改。您可以在提交信息中将该提交归因于多个作者。欲了解更多信息,请参阅 创建拥有多位作者的提交

  9. 如果您的 GitHub 账户关联了多个电子邮件地址,请点击电子邮件地址下拉菜单并选择要用作 Git 作者电子邮件地址的邮箱。仅已验证的电子邮件地址会出现在此下拉菜单中。如果您启用了电子邮件地址隐私,则默认的提交作者电子邮件地址将是 “no‑reply”。有关 no‑reply 邮箱的具体形式,请参阅 设置提交电子邮件地址

    Screenshot of a GitHub pull request showing a dropdown menu with options to choose the commit author email address. octocat@github.com is selected.

  10. 在提交信息字段下方,决定是将提交添加到当前分支还是新分支。如果您当前的分支是默认分支,建议为提交创建一个新分支,然后发起拉取请求。欲了解更多信息,请参阅 创建拉取请求

    Screenshot of a GitHub pull request showing a radio button to commit directly to the main branch or to create a new branch. New branch is selected.

  11. 点击 提交更改提议更改

延伸阅读

  • 前置内容(Front matter)在 Jekyll 文档中的说明
© . This site is unofficial and not affiliated with GitHub, Inc.