报告错误
在开源中,最有价值的角色之一是花时间有帮助地报告错误。
无论我们多么努力,我们永远无法完全消除错误。
即使你无法修复底层代码,良好的错误报告也能使其他对代码库更为熟悉的人发现模式或进行快速修复。
以下是一些关键步骤。
这真的是一个错误吗?
考虑一下你是希望得到帮助,还是认为 Nuxt 本身存在错误。如果是前者,我们很乐意帮助你——但最好的方式是通过 请求帮助 而不是报告错误。
搜索问题
首先搜索 开放问题 和 讨论。如果你发现有任何看起来像同样错误的内容,评论现有线程比创建重复问题要好得多。
创建最小重现
能够可靠地重现错误是非常重要的——以最小的方式并与项目的其余部分分开。这样可以缩小可能导致问题的原因,并使他人不仅能够找到原因,还能测试潜在的解决方案。
从 Nuxt 沙盒开始,添加 最少 的代码以重现你所经历的错误。
如果你的问题涉及 Vue 或 Vite,请先尝试用 Vue SSR 启动项目重现它。
Nuxt:
Vue:
一旦你重现了这个问题,尽可能多地去掉你的重现中的代码(同时仍然能够重现错误)。将重现保持在最小范围所花费的时间,对试图修复问题的人来说会带来巨大的帮助。
找出可能的原因
对于一个 Nuxt 项目,有许多移动的部分——从 Nuxt 模块 到 其他 JavaScript 库。尽量在最相关和最具体的地方报告错误。这可能是导致问题的 Nuxt 模块,或者是 Nuxt 所依赖的上游库。