报告 Bug

开源中最有价值的角色之一就是花时间报告有用的 bug。

无论我们怎么努力,我们永远无法完全消除 bug。

即使你无法修复底层代码,很好地报告一个 bug 也可以让其他对代码库更熟悉的人发现模式或快速修复。

以下是几个关键步骤。

这真的是 bug 吗?

考虑你是想要获得某方面的帮助,还是你认为 Nuxt 本身有 bug。如果是前者,我们很乐意帮助你——但最好的方式是寻求帮助而不是报告 bug。

搜索 Issues

首先搜索 open issuesdiscussions。如果你发现任何看起来是同一个 bug 的内容,最好是在现有线程上评论而不是创建重复的。

创建最小复现

能够以最小的方式可靠地复现 bug,并与你的项目的其余部分分开是非常重要的。这缩小了可能导致问题的范围,并使某人不仅能找到原因,还能测试潜在的解决方案。

从 Nuxt sandbox 开始,添加复现你遇到的 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 依赖的上游库。