文件版本 v2026.10.17.0

下載 PDF

匯入失敗

適用平台與對象

Apple 版使用者；用於判斷來源錯誤、路徑不匹配與開啟失敗。

前置條件

保留原始輸入、副檔名、所走入口和錯誤文字。

操作步驟

1. 確認使用 File 還是 Folder。Folder 新建要求有效 KiCad 專案，不能用來匯入任意製造目錄。
2. 多圖紙原理圖應提供完整專案；單個 .kicad_sch 不會自動補齊外部子圖紙。
3. 先讓雲端硬碟或檔案提供者把來源下載到本機，再選擇檔案／目錄。
4. IPC-2581 按實際用途選擇設計或製造意圖。
5. 若提示無變化，檢查是否重複匯入同名、同格式、相同位元組內容；這可能是正常去重。
6. 記錄失敗發生在檔案選擇、資料入庫還是 Viewer 首幀準備。等待已有匯入結束後再試。

現象	下一步
檔案選擇器無法選擇來源	核對入口、副檔名與格式覆蓋
目錄缺少專案檔	提供完整 .kicad_pro 專案，或改用 File 匯入單板
資料庫已出現文件，開啟失敗	保留文件，記錄 Viewer 的具體階段與錯誤
2D 可開啟，3D 資源缺失	檢查模型和專案相依，不要把它歸為全部匯入失敗
畫面缺少關鍵幾何	記錄缺失範圍和樣例，不能因為開啟成功就當作完整正確

結果

把問題定位到來源、入口、讀取、解析或顯示階段，便於重現。

常見問題

改副檔名能解決嗎？

不能。解析依賴實際內容與專案結構。

偶發失敗需要記錄嗎？

需要。記下首次失敗和重試差異，不以一次成功覆蓋原始錯誤。

最近驗證日期

2026-09-11：依據目前 Library Guide、專案實操及來源規則核對；未逐項製造錯誤輸入。