报告错误

在开源中,花时间帮助报告错误是一个非常有价值的角色。

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

即使你不能修复底层代码,正确地报告错误也能让其他人更容易地发现模式或快速修复。

以下是一些关键步骤。

它真的是一个错误吗?

考虑一下你是否需要帮助解决问题,还是认为 Nuxt 本身存在错误。如果是前者,我们很乐意帮助你 - 但最好的方式是通过寻求帮助而不是报告错误。

搜索问题

首先搜索开放问题讨论。如果你发现任何看起来是相同错误的东西,最好在现有线程上留言而不是创建一个重复的帖子。

创建最小重现

能够可靠地重现错误是很重要的 - 以最小的方式和项目其他部分分开。这缩小了可能引起问题的原因,并使某人不仅能够找到原因,而且还能够测试潜在的解决方案。

从 Nuxt 沙盒开始,添加尽可能少的代码来重现你遇到的问题。

如果你的问题涉及到 Vue 或 Vite,请首先尝试在 Vue SSR 启动器中重现。

Nuxt:

Nuxt 在 StackBlitz 上

Nuxt 在 CodeSandbox 上

Vue:

Vue SSR 在 StackBlitz 上

Vue SSR 在 CodeSandbox 上

Vue SSR 模板在 GitHub 上

一旦你重现了问题,就从你的重现中移除尽可能多的代码(同时仍然重现错误)。花在使重现尽可能最小化的时间将对任何打算修复问题的人产生巨大影响。

找出可能的原因

在 Nuxt 项目中,有许多组成部分 - 从 Nuxt 模块其他 JavaScript 库。试着在最有相关性和特定性的地方报告错误。这可能是导致问题的 Nuxt 模块,或者是 Nuxt 依赖的上游库。