Vue Academy · 课时

错误边界组件

Q: 「错误边界组件」这节课中我会学到什么？

构建带有 fallback 插槽和错误显示功能的 ErrorBoundary 包装组件 你通过在浏览器中直接运行的动手代码来练习 Vue Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

构建带有 fallback 插槽和错误显示功能的 ErrorBoundary 包装组件

错误边界组件 是 CoddyKit 上的免费 Vue Academy 课时。这是第 2 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Vue Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Vue Academy 课程共包含 4 节课。

什么是错误边界

错误边界是一种可复用组件，它包裹界面的一部分，捕获其中的错误，并显示备用界面，而不是让整个应用崩溃。

核心理念

边界会维护一个 hasError 标志。该标志为 false 时，它会渲染子组件；捕获错误后，标志会变为 true，并渲染备用界面。

import { ref } from "vue";
const hasError = ref(false);

捕获错误

使用 onErrorCaptured 设置标志并停止传播，让边界完全负责处理该失败。

import { onErrorCaptured } from "vue";
onErrorCaptured((err) => {
  hasError.value = true;
  return false;
});

保存错误详情

同时捕获错误本身，这样备用界面就可以显示消息，或者您可以提供重试功能。

const error = ref(null);
onErrorCaptured((err) => {
  hasError.value = true;
  error.value = err;
  return false;
});

模板结构

状态正常时渲染默认插槽（子组件），发生错误时渲染备用插槽。

<template>
  <slot v-if="!hasError" />
  <slot v-else name="fallback" :error="error" />
</template>

默认插槽显示子组件

默认插槽包含受保护的界面。在正常情况下，边界是不可见的，只会将子组件直接传递出去。

<ErrorBoundary>
  <RiskyWidget />
</ErrorBoundary>

错误时显示备用插槽

为错误界面提供一个命名为 fallback 的插槽。它可以通过作用域插槽属性接收错误。

<ErrorBoundary>
  <RiskyWidget />
  <template #fallback="{ error }">
    <p>Something went wrong: {{ error.message }}</p>
  </template>
</ErrorBoundary>

添加重试功能

公开一个 reset，让用户能够恢复。某个方法会清除标志并重新渲染子组件。

function reset() {
  hasError.value = false;
  error.value = null;
}

在备用界面中重试

通过作用域插槽将 reset 传递出去，这样备用界面就可以提供“再试一次”按钮。

<slot v-else name="fallback" :error="error" :reset="reset" />

默认回退内容

为回退插槽提供合理的默认内容，这样即使没有提供自定义回退内容，边界也能正常工作。

<slot name="fallback" :error="error">
  <p>An error occurred.</p>
</slot>

边界为何重要

没有边界时，一个故障小部件就可能导致整个视图崩溃。边界可以隔离故障，让应用的其余部分继续工作——这是提高韧性的关键模式。

快速检查

错误边界如何决定要渲染什么内容？

回顾

您构建了一个错误边界：一个 hasError ref、一个用于设置该状态并返回 false 的 onErrorCaptured、一个用于渲染子内容的默认插槽，以及一个在发生错误时显示的回退插槽（包含错误和重置功能），从而将故障与应用的其余部分隔离开来。

常见问题解答

「错误边界组件」课时是免费的吗？

是的 — 「错误边界组件」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Vue Academy 课程的其余内容，请升级到 CoddyKit PRO。 Vue Academy 课程共包含 4 节课。

「错误边界组件」这节课中我会学到什么？

构建带有 fallback 插槽和错误显示功能的 ErrorBoundary 包装组件你通过在浏览器中直接运行的动手代码来练习 Vue Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Vue Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Vue Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 2 节课，共 4 节。

「错误边界组件」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Vue Academy 课中编写并运行代码吗？

能。每节 Vue Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Vue Academy