報告 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 所依賴的上游庫。