报告 Bug

在开源领域中,最有价值的角色之一就是花时间以有益的方式报告 Bug。

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

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

以下是一些关键步骤。

这真的是一个 Bug 吗?

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

搜索现有 Issue

首先搜索开放 Issue等等讨论。如果您发现任何看起来相同的 Bug,最好是在现有帖子下评论,而不是创建重复的 Issue。

创建最小复现

能够以最小化方式、独立于项目其他部分可靠地复现 Bug 至关重要。这有助于缩小问题原因范围,并使他人不仅能找到原因,还能测试潜在解决方案。

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

如果您的 Issue 涉及 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 所依赖的上游库。