makepad-2.0-troubleshooting

makepad-2.0-troubleshooting 技能概觀

makepad-2.0-troubleshooting 是一個專門處理 Makepad 2.0 與 Splash 型應用程式疑難排解的技能。當你已經有明確症狀——像是 UI 看不到、點擊沒反應、編譯錯誤、hot reload 失敗，或是升級後回歸問題——它最有用，能幫你快速縮小到最可能的原因與修正方式。如果你正在為 Backend Development 或 UI 密集型工具鏈除錯 Makepad 2.0 應用，這個技能的設計目標就是減少猜測，並把症狀轉成可落地的程式碼修正。

這個 makepad-2.0-troubleshooting 技能最適合什麼情境

當你要的是「症狀 → 修正」的指引，而不是泛用的 Makepad 入門說明時，就適合使用 makepad-2.0-troubleshooting 技能。它特別擅長處理：

• 讓控制項消失的版面配置問題
• 語法與 macro 遷移錯誤
• 事件、渲染與更新迴圈問題
• 看起來「幾乎正常」但又差一點的執行期行為

它和一般提示詞有什麼不同

一般提示詞往往只會給出很寬泛的建議，卻容易漏掉 Makepad 特有的坑，例如 Fill 與 Fit 的差異、script_mod! 遷移，或命名／覆寫語法。這份 makepad-2.0-troubleshooting 指南是圍繞常見失敗模式與具體修正方式設計的，所以當你的主要目標是診斷與修復時，它更適合安裝使用。

輸出內容會長什麼樣子

當你能提供精確症狀、周邊片段，以及出問題的檔案時，這個技能的效果最好。你可以期待它指出根因、示範修正後的寫法，並提醒那些常常和同一個 bug 一起出現的相鄰問題。它不是完整的框架教學；它是幫你更快解決問題的疑難排解層。

如何使用 makepad-2.0-troubleshooting 技能

在具備 repo 感知的工作流程中安裝

先在你的 skills 工具流程中安裝 makepad-2.0-troubleshooting，然後只在任務明確屬於 Makepad 2.0 破損或失效時使用。為了得到最佳效果，請把當前需求控制在單一 bug、單一檔案或單一步驟的遷移上，這樣技能才能把症狀對應到正確的陷阱。

請把症狀交給技能，不要只給模糊目標

最有效的 makepad-2.0-troubleshooting 用法，會從一個具體回報開始：

• 不佳：「我的 app 壞了」
• 較好：「一個位於 Fit父層中的View 會以 0px 高度渲染」
• 較好：「升級到 Makepad 2.0 之後，live_design! 無法編譯，我需要替代寫法」

請附上：

• 精確的錯誤訊息（如果有）
• 最小且相關的程式碼片段
• 你原本預期看到什麼
• 這是遷移問題、渲染問題，還是事件問題

先讀這些檔案

在使用 makepad-2.0-troubleshooting 時，先預覽 SKILL.md，再看 references/error-solutions.md。這兩個檔案能最快把症狀對上修正方式。如果你的本機副本還有額外的 context 檔或連結文件，請先確認問題類別後再看，因為這裡真正的價值在於已整理好的「陷阱 → 解法」對照。

用以診斷為先的提示詞結構

一個有力的提示通常會像這樣：

我在使用 Makepad 2.0。把 View 巢狀放進 Fit 父層後，我的 Window 內容完全看不見。這裡是版面配置程式碼與完整的容器階層。請判斷最可能的原因，並示範正確的寫法。

這比單純問「有什麼建議」更有效，因為技能可以直接錨定已知的坑點，輸出更窄、更實用的修正。

makepad-2.0-troubleshooting 技能常見問答

這個技能只處理 Makepad 2.0 遷移問題嗎？

不是。遷移錯誤是主要用途之一，但 makepad-2.0-troubleshooting 技能也涵蓋執行期 bug、版面問題、事件處理問題，以及「為什麼什麼都沒顯示」這類在程式已經能編譯後仍會發生的情況。

我可以拿它取代文件閱讀嗎？

請把它當成快速疑難排解層，而不是核心文件的替代品。當你已經有明確症狀，並且想要最短路徑修正時，它最有價值。如果你是在從零設計 app，一般的 Makepad 指南通常會是更好的起點。

它適合初學者嗎？

適合，只要你能提供錯誤訊息或最小片段。makepad-2.0-troubleshooting 指南之所以對初學者友善，是因為它會用清楚的「症狀／原因／修正」語言來整理問題。若你只說「它不能用」而沒有上下文，它就會幫助有限。

什麼情況下不該用這個技能？

不要把它拿來處理大方向的架構決策、UI 設計模式，或不相關的 Rust 除錯。它很適合處理 Makepad 特有的破損問題，但如果失敗點在框架已知陷阱之外，就不是它的強項。

如何改進 makepad-2.0-troubleshooting

提供精確的 Makepad 2.0 情境

makepad-2.0-troubleshooting 技能在你提供版本、檔案類型，以及出錯程式碼路徑時表現最好。請說明你是在 script_mod!、widget tree，還是 event handler 裡面，因為正確修法往往取決於 bug 出現的位置。

提供最小可重現片段

精簡片段比整個 app 傾倒過來更好。例如，如果按鈕點擊沒有觸發，請只附上相關的 widget 階層與 handler 程式碼。這能幫技能分辨是命名問題、可見性問題，還是事件傳遞問題。

不只問診斷，也要問修正模式

要讓 makepad-2.0-troubleshooting 用得更好，請直接要求：

• 可能的根因
• 修正後的程式碼模式
• 需要一起檢查的鄰近邊界情況

這樣的組合比一句話答案更有用，因為它能幫你驗證修正，並避開下一個坑。

在第一輪回答後持續迭代

如果第一個修正沒有解決問題，請回覆新的錯誤、修改後的片段，以及仍然壞掉的部分。這個技能在你逐步縮小問題樹的分支時最有效，而不是每次都從零開始。