透過 100+ 個技巧學習 Nuxt!

回報錯誤

在開源專案中最有價值的角色之一,是花時間以有幫助的方式回報錯誤。

儘管我們盡力而為,但我們永遠無法完全消除錯誤。

即使您無法修復底層程式碼,良好地回報錯誤也能讓對程式碼庫更熟悉的人發現模式或進行快速修復。

以下是一些關鍵步驟。

這是真的錯誤嗎?

請考慮您是否正在尋求某方面的協助,或者您是否認為 Nuxt 本身存在錯誤。 如果是前者,我們很樂意協助您 - 但最好的方法是透過「尋求協助」而不是「回報錯誤」。

搜尋問題

首先搜尋開放問題討論。如果您發現任何看起來像是相同的錯誤,最好在現有的討論串中留言,而不是建立重複的內容。

建立最小重現

能夠可靠地重現錯誤非常重要 - 以最小的方式,並且與您專案的其餘部分分開。 這縮小了可能導致問題的原因,並使其他人不僅可以找到原因,還可以測試潛在的解決方案。

從 Nuxt 沙箱開始,並加入重現您所遇到的錯誤所需的「最少」程式碼量。

如果您的問題與 Vue 或 Vite 有關,請先嘗試使用 Vue SSR starter 重現它。

Nuxt:

Nuxt 在 StackBlitz 上

Nuxt 在 CodeSandbox 上

Vue:

Vue SSR 在 StackBlitz 上

Vue SSR 在 CodeSandbox 上

Vue SSR 模板在 GitHub 上

一旦您重現了問題,請從您的重現中刪除盡可能多的程式碼(同時仍然重現該錯誤)。 花費時間使重現盡可能簡潔,對於著手修復問題的人來說,將產生巨大的差異。

找出可能的原因

在 Nuxt 專案中,有很多活動的部分 - 從 Nuxt 模組其他 JavaScript 函式庫。 嘗試在最相關和特定的地方回報錯誤。 那很可能是導致問題的 Nuxt 模組,或是 Nuxt 所依賴的上游函式庫。