開啟 3 天免費試用
註冊即可免費體驗全部高級功能。
*只限新用戶；每位用戶只可獲得一次試用。
Arduino 開發板安裝失敗：如何分辨索引、核心及工具鏈下載？
Ryan Foster
2026年10月7日· 7 分鐘讀完
Arduino 開發板安裝失敗時，先找出最早未完成的索引或壓縮檔請求，再考慮板卡選擇及網絡設定。保存草圖，固定核心版本，以獲准連接重試原套件；能否上載韌體是另一項結果。
關鍵要點：
- 套件索引、板卡核心及編譯器工具屬不同安裝對象。
- 再按安裝之前，先記下廠商、套件名稱及版本。
- 比較原本失敗的請求，保留校驗和驗證。
- 核心裝好不代表 USB 驅動程式或上載連接埠正常。
Arduino 開發板安裝失敗指向哪個環節？
訊息表示安裝中斷，並不能直接判斷開發板損壞。開發板管理器安裝支援板卡所需的核心套件，當中包含編譯及上載草圖的檔案。開啟 Tools → Board → Boards Manager，找出確實包括該板卡的套件，查看安裝情況。［1］
同一套件可包含多款板卡。記下廠商、名稱、所選版本、IDE 版本、作業系統及架構，先另存草圖。若其他應用亦連接失敗，先按裝置與應用排障次序處理，不要清空 Arduino 設定來排查整部電腦。
有用的紀錄是第一個失敗請求的主機、資產名稱、錯誤內容及有否開始傳輸。私下保存原始日誌，分享節錄前刪除代理憑據、權杖、用戶名稱及私人路徑。最後的安裝摘要可能掩蓋真正停止的是哪個請求。
步驟 1：哪個安裝對象停止下載？
查看原開發板管理器操作的輸出。套件索引下載與索引指定的核心或編譯器壓縮檔是不同步驟。Arduino 設定把存放索引及已安裝平台的資料目錄，與暫存下載壓縮檔的目錄分開。［2］
| 現象 | 要保留的對象 | 接着檢查甚麼 |
|---|---|---|
| 更新失敗，尚未顯示套件或版本清單 | 官方或已批准廠商索引 | 索引 URL 及連接設定 |
| 套件已列出，但壓縮檔逾時 | 核心套件及所選版本 | 該檔案的主機與傳輸 |
| 核心取得進展，工具壓縮檔失敗 | 工具名稱、版本、主機架構 | 指定的工具依賴 |
| 下載完成，解壓失敗 | 壓縮檔及安裝位置 | 儲存空間、權限或完整性 |
| 核心已安裝，上載失敗 | 板卡、連接埠、上載錯誤 | 另查 USB 及上載 |
不要見到論壇索引有相似板卡名稱就加入。第三方硬件應跟從廠商官方指引，保留已批准 URL；錯拼或停用索引需要修正地址，不是輪換 VPN 位置。求助時亦不要公開內部索引地址。
基線可記為「X 套件、Y 版本、Z 編譯器檔案傳輸逾時」。日誌只有期限超出，不能據此聲稱供應商封鎖下載。以下步驟檢驗連接是否可能是原因，錯誤名稱本身不能重建歷史原因。
步驟 2：如何保留核心版本及草圖？
重試前記下管理器所選版本。介面可能預設最新發佈，應重新選取項目需要的版本。安裝無關新版本會改變比較對象，亦可能影響板卡定義和程式庫兼容性。［1］
CLI 項目先查看原指令與設定。安裝語法接受套件廠商、架構及可選版本。以下只展示指令形式，不推薦板卡；須用已記錄值替換三個標籤，不能原樣貼上。［3］
arduino-cli core install VENDOR:ARCH@VERSION
arduino-cli core list
使用原失敗操作的設定環境。後來另裝的 CLI 可能使用不同於 IDE 的資料目錄。若無法確認原請求由誰執行，就留在開發板管理器復測，不把另一個 CLI 成功當成 IDE 恢復。
保留草圖目錄、程式庫及其他核心。刪除整個 Arduino 資料目錄會移除無關平台，令復原工作擴大。快取亦影響判斷：沒有傳輸而由快取完成安裝，只能記錄安裝恢復，不能說遠端下載已獲驗證。
步驟 3：Arduino 開發板管理器逾時要查哪些設定？
先檢查實際下載程序的連接設定。Arduino CLI 有 network.proxy 與 network.connection_timeout；優先次序為指令參數、環境變數、設定檔。檔案中的值可能被啟動方式覆蓋。［2］
只在相關 CLI 執行 arduino-cli config dump，私下查看輸出。修改前核對代理模式、啟動環境、目錄及逾時。IDE 執行原工作時，不能假定無關終端機工作階段的設定控制 IDE 下載器。
受管理電腦須遵守機構代理和證書要求。若指向本機代理，檢查其程序是否運作。Windows 可參照系統代理與應用代理的分別，但系統設定改變不代表原請求確實使用預期路徑。
文檔的逾時指網絡沒有活動的時間。延長它不能修復拒絕連接、缺失資產或證書驗證。不要預設無限等待；只有傳輸持續進行，並核對當前版本語義、記錄舊值後，才考慮有上限的調整。
身份驗證、證書、磁碟滿、解壓與校驗和錯誤應各自處理。不要啟用不安全安裝或關閉 HTTPS 驗證來取得綠色結果。證書問題交由管理員確認信任設定，不匯入網上隨意下載的證書。
步驟 4：如何比較 Arduino 套件索引下載？
只有證據指向建立連接或傳輸中斷才比較路徑。先在原連接重試一次，保留套件、版本及已批准索引，確認是否相同主機失敗。若已進入另一安裝階段，應記錄變化，不把所有新錯誤當成原逾時。
索引可更新、編譯器壓縮檔卻停住時，要分開記錄結果。針對這個本地工具鏈請求，在執行管理器或 CLI 的電腦連接 AethoVPN，開啟全局模式，從 App 現有清單選本國或就近位置。Windows 用官方安裝包；Linux 限 Debian/Ubuntu x64 .deb；Mac 按官方向導取得設定，在 VPN 客戶端連接，桌面使用 Pro 或 Premium。
重裝已記錄的核心版本，觀察原本失敗的工具檔案，而不是另一款板卡套件。這項比較不替你選硬件包、修 USB 驅動或取得廠商許可。需要新帳戶做對照時，可用電郵開始每人一次的 3 天免費 Pro 試用。
先按針對 Arduino 電腦的 VPN 路由檢查確認連接，再返回 Arduino 輸出。連接圖示、公共 IP 改變或瀏覽器首頁可開啟，都不是安裝驗收；這種套件比較亦毋須查公共 IP。
手提電腦連上 VPN 不代表遠端建置機改變路徑。CLI 若在容器、虛擬機或 CI 節點運行，先找其網絡負責人，在該處做獲准對照。消費 VPN 亦不會自動提供公司私人套件伺服器的入口。
步驟 5：如何驗收安裝及安全結束？
等待管理器報告所選套件已安裝。重新核對條目的版本，或在相同 CLI 環境查看 core list。確認原來缺失工具不再出現同一下載錯誤，不要只看到索引清單就結束。［1］［3］
- 把最終套件及版本與基線比較。
- 查看原缺失編譯器或工具的安裝輸出。
- 確認板卡選單可選取預期板卡。
- 還原臨時且獲准的連接設定。
- 將結果與之後的編譯、上載分開記錄。
小型編譯可作後續檢查，但失敗不抹去套件傳輸完成的證據。相反，用舊快取工具編譯成功也不能證明新檔案已取得。SDK 與 Gradle 下載階段排查解釋取得與建置為何分開驗收，其中設定不適用於 Arduino。
遇到發佈資產缺失、校驗和不符、主機架構不受支援、權限拒絕或儲存錯誤時，停止改路徑，保留驗證並找廠商或 IT。提供脫敏的 IDE/CLI 版本、廠商與核心版本、失敗主機及資產、時間、階段和比較結果，不上載整個主目錄設定。
若只有斷開 VPN 才恢復，保留那個獲准可用路徑並如實記錄。這是診斷比較，不代表某線路必定可用。重複失敗又沒有新階段資訊，就停止疊加設定並求助。
總結
- 分開索引更新、核心取得及工具依賴安裝。
- 保留已批准索引、版本、草圖及其他平台。
- 比較獲准路徑前，核對下載器的代理環境。
- 驗收核心與工具；USB、編譯及上載另行處理。
常見問題
官網能開啟，管理器仍會下載失敗嗎？
會。瀏覽器頁面不能驗證管理器需要的索引或壓縮檔。找出失敗主機及資產，重做原安裝操作，不以首頁可開啟代替套件傳輸完成。
期限超出是否代表板卡損壞？
不能如此判斷。安裝期限關乎電腦取得軟件，板卡通訊是另一階段。保留型號紀錄，但更換硬件前先查缺失索引或工具壓縮檔。
要改裝最新核心來避開逾時嗎？
比較期間保留項目所需版本。另一版可能要求不同檔案並改變兼容性，不能證明原工作恢復；升級應在項目批准後另行安排。
延長逾時就能完整修復嗎？
有上限的調整可能幫助持續傳輸，但不能解決缺失資產或建連失敗。核對無活動逾時語義、保存舊值，不用無限等待掩蓋重複失敗。
可以刪除 Arduino 資料目錄重來嗎？
避免整體刪除，因為其中有索引及已安裝平台，不只是失敗下載。保留草圖與其他核心，按官方套件流程窄範圍處理已定位問題。
怎樣才算板卡套件恢復？
原版本核心須在相同 IDE 或 CLI 環境安裝完成，所需工具可用。套件清單出現或舊工具能燒錄，都不能證明失敗檔案已下載。
何時應聯絡廠商或管理員？
受控比較仍重複失敗，或身份驗證、校驗和、架構、證書及儲存錯誤取代逾時時，便應停止。分享脫敏資產紀錄，不輪換無關索引和版本。
來源
- Arduino — Add boards to Arduino IDE — https://support.arduino.cc/hc/en-us/articles/360016119519-Add-boards-to-Arduino-IDE
- Arduino CLI — Configuration — https://docs.arduino.cc/arduino-cli/configuration/
- Arduino CLI — core install — https://docs.arduino.cc/arduino-cli/commands-reference/arduino-cli_core_install
Sources checked 2026 年 10 月 7 日。
