报告 Bug
开源中最有价值的角色之一就是花时间报告有用的 bug。
无论我们怎么努力,我们永远无法完全消除 bug。
即使你无法修复底层代码,很好地报告一个 bug 也可以让其他对代码库更熟悉的人发现模式或快速修复。
以下是几个关键步骤。
这真的是 bug 吗?
考虑你是想要获得某方面的帮助,还是你认为 Nuxt 本身有 bug。如果是前者,我们很乐意帮助你——但最好的方式是寻求帮助而不是报告 bug。
搜索 Issues
首先搜索 open issues 和 discussions。如果你发现任何看起来是同一个 bug 的内容,最好是在现有线程上评论而不是创建重复的。
创建最小复现
能够以最小的方式可靠地复现 bug,并与你的项目的其余部分分开是非常重要的。这缩小了可能导致问题的范围,并使某人不仅能找到原因,还能测试潜在的解决方案。
从 Nuxt sandbox 开始,添加复现你遇到的 bug 所需的最少代码量。
如果你的问题涉及 Vue 或 Vite,请尝试先用 Vue SSR starter 复现它。
Nuxt:
Vue:
一旦你复现了问题,请从你的复现中删除尽可能多的代码(同时仍然重新创建 bug)。花时间使复现尽可能小,将对任何着手修复问题的人产生巨大的影响。
找出可能的原因
对于 Nuxt 项目,有很多移动部分——从 Nuxt 模块到其他 JavaScript 库。尝试在最相关和最具体的地方报告 bug。这很可能是导致问题的 Nuxt 模块,或者是 Nuxt 依赖的上游库。