Nuxt3 中文课程 《实战全栈开发简书》.

报告错误

在开源项目中,报告错误是其中一个最有价值的角色,它能够帮助其他对代码库更为熟悉的人发现问题或进行快速修复。

尽管我们尽力去除错误,但永远也无法完全消除它们。

即使你无法修复底层代码,但通过合理地报告错误,可以让其他对代码库更为熟悉的人发现问题的模式或进行快速修复。

以下是几个关键步骤。

是真的有错误吗?

首先考虑你是在寻求帮助,还是认为 Nuxt 本身存在错误。如果是前者,我们非常乐意帮助你,但最好的方式是通过寻求帮助而不是报告错误。

搜索问题

首先搜索未解决的问题讨论。如果你发现类似的错误,最好在现有的讨论中发表评论,而不是创建重复的问题。

创建最小化复现

重要的是能够可靠地复现错误 - 以最小的方式,与项目的其他部分分离开来。这将缩小可能导致问题的范围,并使其他人不仅能够找到原因,还能够测试潜在的解决方案。

从 Nuxt 3 或 Nuxt Bridge 的沙盒开始,添加最小量的代码,以复现你遇到的错误。

如果你的问题涉及到 Vue 3 或 Vite,请先尝试使用 Vue 3 SSR starter 进行复现。

Nuxt 3:

在 StackBlitz 上的 Nuxt 3

在 CodeSandbox 上的 Nuxt 3

Nuxt Bridge:

在 CodeSandbox 上的 Nuxt Bridge

Vue 3:

在 StackBlitz 上的 Vue 3 SSR

在 CodeSandbox 上的 Vue 3 SSR

在 GitHub 上的 Vue 3 SSR 模板

在复现问题后,尽量删除你的复现代码中的多余部分(同时仍然能够重现错误)。花费时间使复现代码尽可能简化,对于负责修复问题的人来说将会有重大的帮助。

确定可能的原因

在一个 Nuxt 项目中,有许多组件在运作 - 从Nuxt 模块其他 JavaScript 库。尽量将错误报告到最相关和具体的位置。可能是由 Nuxt 模块引起的问题,或者是 Nuxt 依赖的上游库引起的。