Micro:bit 錯誤代碼

修改時間：2023年6月22日星期四早上 10:38

如果 micro:bit 資源耗盡或偵測到故障，它會進入「恐慌」程序，在 micro:bit 螢幕上顯示一張悲傷的臉即出現錯誤代碼，例如：529。

出現異常時，按下 micro:bit 背面的重置按鈕會重新啟動程序，清除記憶體（RAM）並重新啟動。

以下是錯誤代碼列表，解說了錯誤的原因及修復辦法，另外也可在支援網站上個別查詢：

硬體錯誤Hardware errors (010-099)

錯誤代碼	描述
010	micro:bit 的 I2C總線未正常運作，設備可能已損壞。
020	micro:bit 無可用記憶體。您的程式可能過於複雜或含有過多的變數。請嘗試利用函數功能減少編碼的行數。
030	偵測到 micro:bit 的內存空間（heap space）損壞（通常為儲存變數的區塊）。請嘗試將不同的 .hex 文件載入您的設備。
040	您的 micro:bit 無法正常執行腳本。請載入不同的 .hex 文件，然後再試著載入並執行原本的腳本。
042	您的 micro:bit 無法正常執行腳本。請載入不同的 .hex 文件，然後再試著載入並執行原本的腳本。
043	micro:bit 的無線電組件發生錯誤。
050	micro:bit 的加速度計組件發生錯誤。
051	micro:bit 的磁力計組件發生錯誤。
090	實際板硬件與配置描述不符。這是一個罕見的錯誤，請向micro:bit教育基金會報告。
098	判斷指示（assert）錯誤。此為程式邏輯中的斷言（assert）條件為假時會發生的 MakeCode 錯誤。

MakeCode 編輯器錯誤 (800 - 989)

MakeCode 編輯器產生的錯誤。遇到此情況，請將錯誤回報給我們。如果您習慣使用 Github ，請在編碼庫中提交問題。

垃圾回收器（Garage collector）錯誤

錯誤代碼	描述
840	分配指針為空或無效。
841	垃圾收集器的工作序列錯誤。
843	VTable 條目無法實現。
844	對於請求的字節數，GC分配失敗。
846	分配線程無效。
848	分配指針超出份配標頭。
849	分配指針為空。

程式讀取錯誤

錯誤代碼	描述
901	物件的標頭無效。
902	物件的部分數據大於其定義的長度。
903	物件引用已刪除，不再有效。
904	物件大小與其定義的尺寸不符。
905	物件的虛擬函數表（VTable）無效或未初始化。
906	內部資源錯誤。
907	指定的設備資源不存在。
909	參數值超出範圍或類型、格式無效。
927	該程式與您使用的 micro:bit 版本不相容。您在 micro:bit V1 上使用的功能為 micro:bit V2 專用，或僅限新舊版皆可使用的擴充。
928	micro:bit 數據日誌已滿，清除現有數據或將新程式載入 micro:bit

JavaScript 執行時代碼

例如，當靜態類型 x 是 c 類；動態類型 x 不是 c ，當您嘗試讀取字段 x 或調用方法 x，您將獲得以下其中一個代碼，具體取決於動態類型 x 。

錯誤代碼	描述
980	`x` 值未定義
981	`x` 值為 `true` 或 `false`
982	`x` 值為數字
983	`x` 為字串
984	`x` 為某類型物件
985	`x` 值為一個函數
989	`x` 值為空

MicroPython 操作系統錯誤

我們已發布了一個 MicroPython OS Error 代碼表，以及當操作時導致系統相關錯誤時引發的問題描述，其中也包含了 I/O 故障，例如：「找不到文件（file not foung）」或「磁碟已滿（disk full）」。

USB DAPLink 錯誤 (500 - 599)

以5 開頭的錯誤表示為透過 USB 將文件載入 micro:bit 時會出現的常見錯誤，描述如下。

但如果 500-599 範圍內的錯誤經常發生，請連同MICROBIT 驅動器的DETAILS.TXT文件及錯誤一併回報給我們。

錯誤代碼	描述
502	micro:bit 出現內部錯誤。這可能發生在拖曳閃存的過程中。請嘗試斷開後重新連接 micro:bit。
504	將 hex 文件傳輸到 micro:bit 已超時。這意味著載入時間過長。我們目前正在調查此錯誤，因為已發生許多次，如遇到此問題，請連同 MICROBIT 驅動器的 DETAILS.TXT 文件及造成錯誤的文件一併回報給我們。
506	hex 文件無法執行。意味著 .hex 文件中的代碼是 micro:bit 未預料到的。如果前一個文件未完成刷新就將 .hex 文件拖曳到設備內便可能發生此情況。請嘗試斷開後重新連接 micro:bit 並刷新不同的 .hex
521	到達 micro:bit 的十六進製文件數據傳輸已損壞。導致此錯誤的原因是十六進製文件格式的校驗和失敗。您還可能在 micro:bit 上找到一個 FAIL.TXT 文件，其措辭如下：錯誤：hex 文件無法解碼。發生校驗和計算失敗。類型：瞬態、用戶我們目前正在調查另一個問題，即用戶報告通過將文件複製到 MICROBIT 驅動器來刷新 micro:bit 失敗，請參閱自 2023 年 2 月 Windows 更新以來將文件傳輸到 micro:bit 時出錯
528	micro:bit 檢測到不支援的更新。如果您在正常的 MICROBIT 模式下嘗試刷新硬體 .hex 文件，就會發生此情況。請使用在任一線上編輯器中建立的文件刷新 .hex 以解決該問題。
529	micro:bit 檢測到不相容的圖像。如果您嘗試使用最新的 micro:bit 刷新舊的 .hex 文件，就會發生這種情況。請嘗試在其編輯器中更新 hex 文件後重新下載。