疑難排解

從可觀察到的症狀開始，將應用程式縮減到最小的失敗圖表。

安裝失敗

請確認：

• Node.js is >=22.19.0.
• Nuxt is ^4.1.0 and Nuxt Content is >=3.5.0 <4.0.0.
• Nuxt Content 的資料庫連接器已成功安裝。
• 如果 pnpm 阻擋了原生連接器的建置腳本，請檢閱該腳本並使用 pnpm approve-builds。

接著，對齊這些版本，並重試開始使用中的未指定版本安裝命令。在除錯此模組前，請先解決資料庫連接器的問題。

建置失敗

請確認：

• @barzhsieh/nuxt-content-mermaid 出現在 Nuxt 的 modules 陣列中。
• 選項使用 contentMermaid，而不是已移除的 mermaidContent 鍵。
• enabled 保持在建置時的 contentMermaid 選項下。
• runtimeConfig.public.contentMermaid 只包含可序列化的純資料。

接著移除所有套件選項，只保留模組註冊並進行建置。如果成功，請一次還原一組選項，並參考升級至 v3了解邊界的變更。

原始碼仍可見

請確認：

• Markdown 圍欄的語言標記恰好是 mermaid。
• 路由渲染的是預期的 Content 頁面，且 JavaScript 已啟用。
• 瀏覽器主控台沒有 hydration、設定或 Mermaid 錯誤。
• 開始使用中的三節點範例也以相同方式失敗。

接著，在直接的 Content 路由上測試這個縮減後的範例。如果能渲染，請逐步還原原始圖表，並使用 Mermaid 文件檢查其語法。如果仍無法渲染，請蒐集路由、相關設定、建置輸出與瀏覽器錯誤。

如果最小範例仍然失敗，請開啟 GitHub issue，並提供套件、Nuxt、Nuxt Content、Node.js 與套件管理器版本、最小可重現範例，以及完整錯誤輸出。