通过 100+ 条技巧学习 Nuxt!

报告 Bug

在开源项目中,最宝贵的角色之一就是花时间以有用的方式报告错误。

尽管我们尽力而为,但我们将永远无法完全消除错误。

即使您无法修复底层代码,良好地报告错误也可以使其他对代码库更熟悉的人能够发现模式或进行快速修复。

以下是一些关键步骤。

这真的是一个 Bug 吗?

请考虑您是想获得某些方面的帮助,还是认为 Nuxt 本身存在 bug。 如果是前者,我们很乐意为您提供帮助 - 但最好的方法是通过寻求帮助,而不是报告错误。

搜索 Issue

首先搜索打开的 issue讨论。 如果您发现任何看起来像是相同的错误,最好在现有线程上发表评论,而不是创建重复项。

创建一个最小的复现

能够可靠地重现该错误非常重要 - 以最小的方式,并且与您项目的其余部分分开。 这缩小了可能导致问题的原因,并使其他人不仅可以找到原因,还可以测试潜在的解决方案。

从 Nuxt 沙箱开始,并添加重现您遇到的错误所需的最少代码。

如果你的问题与 Vue 或 Vite 有关,请先尝试使用 Vue SSR starter 重现它。

Nuxt:

StackBlitz 上的 Nuxt

CodeSandbox 上的 Nuxt

Vue:

StackBlitz 上的 Vue SSR

CodeSandbox 上的 Vue SSR

GitHub 上的 Vue SSR 模板

重现该问题后,请从您的复现中删除尽可能多的代码(同时仍然可以重现该错误)。 花时间使复现尽可能最小化,对于着手解决该问题的人来说,将产生巨大的影响。

找出可能的原因

对于 Nuxt 项目,有很多活动的组件 - 从Nuxt 模块其他 JavaScript 库。 尝试在最相关和最具体的地方报告该错误。 这很可能是导致问题的 Nuxt 模块,或者是 Nuxt 依赖的上游库。