# 自定义 404 页面 (/zh/customize/custom-404-page)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 186 · updated: 2026-07-30 -->
Related: [自定义域名](/zh/customize/custom-domain.md), [主题](/zh/customize/themes.md), [字体](/zh/customize/fonts.md), [自定义脚本](/zh/customize/custom-scripts.md), [React](/zh/customize/react-components.md), [操作台](/zh/api-playground/overview.md)

所有 404 页面都会根据请求的 URL 自动推荐相关页面。如果用户进入 404 页面，智能助手会分析路径，并从你的文档中检索语义相关的页面，帮助他们找到所需内容。

你可以自定义 404 错误页面的标题和描述。可以在描述中添加有用的链接或指引。

<div id="configuration">
  ## 配置 [#配置]
</div>

在 `docs.json` 文件的 `errors.404` 部分配置你的 404 页面：

```json
"errors": {
  "404": {
    "redirect": false,
    "title": "页面未找到",
    "description": "这个_页面_**怎么了**？"
  }
}
```

<div id="parameters">
  ## 参数 [#参数]
</div>

<ResponseField name="redirect" type="boolean">
  当页面不存在时，是否自动重定向到首页。

  设为 `true` 将重定向到首页。

  设为 `false` 将显示自定义 404 页面。
</ResponseField>

<ResponseField name="title" type="string">
  404 错误页面的自定义标题。将替换默认的“Page not found”标题。
</ResponseField>

<ResponseField name="description" type="string">
  404 错误页面的自定义说明。支持 MDX 格式，包括链接、加粗、斜体文本和自定义组件。
</ResponseField>