flutter-errors

此技能專為 Flutter 開發者設計，作為診斷常見運行時異常與佈局衝突的專業工具。它能幫助開發者迅速排除導致應用程式崩潰或渲染異常的問題，無需頻繁查閱龐大的官方文檔。此工具特別適用於在建構使用者介面期間遇到渲染障礙的開發者。

• 透過建議使用 Flexible 或 Expanded 元件包裹佈局，解決 RenderFlex 溢出錯誤。

• 識別 ListView、Column 及 TextField 等組件中導致無界高度或寬度異常的根本原因。

• 說明正確的生命週期方法使用方式，以防止在建構期間呼叫 setState 或 markNeedsBuild。

• 提供當單一視圖中存在多個可滾動組件時，ScrollController 管理的解決方案。

• 建議多種除錯技術，包括使用 Flutter Inspector、啟用 debugPaintSizeEnabled 以及顯示佈局指南。

• 當 IDE 偵測到與 Flutter 渲染管道或元件樹約束相關的錯誤時，建議啟用此技能。

• 使用者應提供錯誤堆疊追蹤或具體的錯誤訊息（例如 RenderBox was not laid out），以觸發最精確的修復建議。

• 輸入內容通常包含 build 方法或元件樹的程式碼片段；輸出內容則包含程式碼等級的修復方案與結構性建議。

• 本技能強調非主觀、符合 Flutter 官方文件模式的解決路徑，而非特定第三方架構。

• 最佳實踐包括驗證元件樹中的約束傳播，並確保透過 addPostFrameCallback 進行正確的生命週期管理。