跳至主要内容

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

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

谁可以使用此功能?

GitHub Pages 可用于具有 GitHub Free 和 GitHub Free for organizations 的公共仓库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。有关更多信息,请参阅“GitHub 的计划”。

从 2024 年 6 月 30 日起,所有 GitHub Pages 构建都将使用 GitHub Actions。无需进行其他更改,但必须在您的仓库中启用 GitHub Actions 才能继续构建。有关启用 GitHub Actions 的更多信息,请参阅“管理仓库的 GitHub Actions 设置”。

  1. 在 GitHub 上,导航到您的网站仓库。

  2. 导航到您网站的发布源。有关更多信息,请参阅“配置 GitHub Pages 网站的发布源”。

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

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

    Screenshot of the main page of a repository. Above the list of files, a button, labeled "Add file," is outlined in dark orange. In the file tree view of the repository, a button with a plus sign icon is also outlined in dark orange.

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

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

    ---
    permalink: /404.html
    ---
    
  6. 如果存在 YAML 前置信息,请在下方添加您想在 404 页面上显示的内容。

  7. 点击 **提交更改...**

  8. 在“提交信息”字段中,输入一个简短、有意义的提交信息,描述您对文件所做的更改。您可以在提交信息中将提交归功于多个作者。有关更多信息,请参阅“创建具有多个作者的提交”。

  9. 如果您在 GitHub.com 上的帐户中关联了多个电子邮件地址,请点击电子邮件地址下拉菜单并选择要作为 Git 作者电子邮件地址使用的电子邮件地址。此下拉菜单中仅显示已验证的电子邮件地址。如果您启用了电子邮件地址隐私,则“无回复”将是默认的提交作者电子邮件地址。有关“无回复”电子邮件地址可能采用的确切形式的更多信息,请参阅“设置您的提交电子邮件地址”。

    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. 点击 **提交更改** 或 **提出更改**。

进一步阅读