Nuxt Nation 大会即将到来。加入我们,时间为 11 月 12-13 日。

报告错误

在开源项目中,花时间有帮助地报告错误是最有价值的角色之一。

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

即使您无法修复底层代码,但如果能很好地报告错误,也可以让其他对代码库比较熟悉的人发现模式或快速修复。

以下是一些关键步骤。

这真的是一个错误吗?

考虑一下您是想寻求帮助还是认为 Nuxt 本身存在错误。如果是前者,我们很乐意帮助您 - 但最好的方法是通过 寻求帮助 而不是报告错误。

搜索问题

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

创建最小重现

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

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

如果您的问题与 Vue 或 Vite 相关,请尝试首先使用 Vue SSR 启动器重现它。

Nuxt:

StackBlitz 上的 Nuxt

CodeSandbox 上的 Nuxt

Vue:

StackBlitz 上的 Vue SSR

CodeSandbox 上的 Vue SSR

GitHub 上的 Vue SSR 模板

重现问题后,尽可能从重现中删除代码(同时仍然重现错误)。花费时间使重现尽可能最小化将对着手修复问题的人产生巨大影响。

找出可能的原因

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