报告 Bug

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

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

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

以下是一些关键步骤。

这真的是一个 Bug 吗?

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

搜索现有 Issue

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

创建最小可复现示例

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

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

如果您的 Issue 涉及到 Vue 或 Vite,请尝试先使用 Vue SSR 启动器复现它。

Nuxt:

StackBlitz 上的 Nuxt

CodeSandbox 上的 Nuxt

Vue:

StackBlitz 上的 Vue SSR

CodeSandbox 上的 Vue SSR

GitHub 上的 Vue SSR 模板

一旦您复现了问题,请尽可能从您的复现示例中删除多余代码(同时仍能重现 Bug)。花时间使复现示例尽可能最小化,将对解决问题的人产生巨大影响。

找出可能的原因

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