通过 100 多个技巧学习 Nuxt!

报告 Bug

在开源中最有价值的角色之一是花时间有效地报告错误。

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

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

以下是一些关键步骤。

这真的是 Bug 吗?

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

搜索 Issues

首先搜索未解决的 issues讨论。如果您发现任何看起来像是相同的 Bug,那么在现有线程上评论比创建重复线程要好得多。

创建最小化复现

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

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

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

Nuxt:

StackBlitz 上的 Nuxt

CodeSandbox 上的 Nuxt

Vue:

StackBlitz 上的 Vue SSR

CodeSandbox 上的 Vue SSR

GitHub 上的 Vue SSR 模板

一旦您重现了问题,请从您的复现中删除尽可能多的代码(同时仍然重现该 Bug)。花时间使复现尽可能最小化将对任何着手修复问题的人产生巨大影响。

找出可能的原因

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