透過 100 多個技巧的集合來學習 Nuxt!

回報錯誤

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

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

即使您無法修復底層程式碼,妥善回報錯誤也能夠讓對程式碼庫比較熟悉的人發現模式或進行快速修復。

以下是一些關鍵步驟。

這真的是錯誤嗎?

請考慮您是想尋求協助,還是認為 Nuxt 本身存在錯誤。如果是前者,我們很樂意為您提供協助 - 但最好的方式是透過請求協助,而不是回報錯誤。

搜尋 Issues

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

建立最小重現

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

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

如果您的問題與 Vue 或 Vite 有關,請先嘗試使用 Vue SSR 起始範本重現。

Nuxt:

StackBlitz 上的 Nuxt

CodeSandbox 上的 Nuxt

Vue:

StackBlitz 上的 Vue SSR

CodeSandbox 上的 Vue SSR

GitHub 上的 Vue SSR 範本

重現問題後,請從重現程式碼中刪除盡可能多的程式碼(同時仍可重現錯誤)。花時間讓重現盡可能地精簡,對於任何想要修復問題的人來說,都會有很大的幫助。

找出可能的原因

使用 Nuxt 專案時,有很多活動的部分 - 從Nuxt 模組其他 JavaScript 函式庫。請嘗試在最相關且具體的位置回報錯誤。這很可能是導致問題的 Nuxt 模組,或是 Nuxt 所依賴的上游函式庫。