文件版本
v2026.07.07.0
下載 PDF
匯入失敗¶
頁面目標¶
協助你快速判斷目前失敗是輸入不支援、匯入路徑不符，還是真實匯入流程中的狀態保護或失敗。
支援平台¶
iOSmacOS
適用對象¶
- 匯入路徑行為不如預期的使用者
- 分析匯入失敗、被忽略的匯入或降級匯入結果的測試人員
前置條件¶
- 你有一個具體匯入案例、訊息或重現路徑要檢查
- 可能的話，保留觸發問題的來源檔與精確匯入路徑
操作步驟¶
- 判斷失敗發生在選檔前、選檔後，還是進入工作區後。
- 檢查使用了哪條匯入路徑，以及來源是否應該在該路徑中支援。
- 將觀察到的行為與下面的失敗模式比對，包含未變更的重新匯入與局部 DSN 降級訊息。
- 重試前先記錄精確訊息與來源上下文。
結果¶
- 你可以把問題縮小到不支援輸入、路徑不符、保護性停止、未變更的重新匯入，或局部降級案例。
先看這三件事¶
- 失敗發生在 選檔前、選檔後，還是 進入工作區後？
- App 是否顯示清楚錯誤訊息？
- 這次動作是 新匯入、追加修訂，還是 SES？
目前最常見的失敗類型¶
1. 不支援的輸入類型¶
典型跡象：
- App 直接說明副檔名不支援
- 選取檔案後流程停止
建議動作：
- 先確認使用的是設計路徑還是製造路徑
- 再確認輸入是否屬於目前支援集合
2. IPC-2581 匯入意圖選錯¶
典型跡象：
- 檔案可以選取，但匯入後行為與預期不同
建議動作：
- 重新匯入一次
- 重新選擇它應被視為設計端或製造端資料
3. SES 使用方式不正確¶
典型跡象：
- 嘗試把
SES當成一般新文件匯入 - 或目前文件沒有可用的基準修訂
建議動作：
- 開啟目標文件選單
- 從
Import SES開始 - 先選擇有效的基準修訂
4. 大型 IPC-2581 開啟很慢或在真實匯入中失敗¶
目前版本會讓非常大的 IPC-2581 XML 輸入進入真實匯入流程。
如果這類來源非常慢或最後失敗，請把它視為真實匯入路徑問題，而不是前置攔截。
建議動作：
- 記錄精確錯誤文字或最後可見的載入階段
- 記錄檔案大小、平台與裝置型號
- 註明 App 是仍有回應、停滯，還是被作業系統終止
5. 已有另一個匯入任務執行中¶
目前版本一次只允許一個 PCB 匯入任務。如果前一個匯入尚未完成，下一個匯入請求會被拒絕並顯示狀態訊息。
6. 同名同格式輸入被判定為未變更¶
當你用相同文件名稱與相同格式重新匯入來源時，目前版本會比較原始來源位元組：
- 如果新匯入的原始來源與目前修訂相同，App 會提示因為沒有變更而忽略匯入
- 這不是失敗，而是用來避免建立重複修訂
- 如果你預期產生新修訂，請確認檔案內容真的已改變
7. DSN 成功匯入後本機幾何品質下降¶
典型跡象：
- 匯入最終成功，且文件可開啟
- 但某些局部細節沒有如預期顯示
它代表：
- 某些局部細節無法顯示，但板件其餘部分仍可使用
- 這個行為用來避免整板匯入失敗或當機，通常只影響局部渲染，而不是整份文件
建議動作：
- 先確認受影響區域對你的任務是否仍可用
- 如果缺失幾何很重要，記錄訊息文字、原始
DSN與重現步驟，以便後續調查
KiCad 特別說明¶
即使 KiCad 板件以 2D 角度成功匯入，缺失或不可讀的專案本地 3D 資產仍可能稍後在 3D 或問題詳情中出現。這不一定會阻擋 2D 開啟，但可能降低 3D 完整度。
需要記錄什麼¶
- 平台與裝置
- 匯入路徑類型：design / manufacturing / SES
- 原始檔案類型與大小
- 原始錯誤文字
- 是否穩定重現
- 是否已有另一個匯入任務正在進行
常見問題¶
為什麼有些製造輸入即使是資料夾也能匯入？¶
因為製造路徑接受目錄型輸入。匯入是否成功，取決於 App 能否辨識該目錄為支援的製造封裝。
為什麼匯入失敗後資料庫沒有新卡片？¶
這通常表示失敗發生在文件建立前，例如輸入不支援、匯入路徑偵測失敗，或真實匯入流程提早停止。
為什麼第二次匯入同名檔案後沒有得到新修訂？¶
如果 App 說因為沒有變更而忽略匯入，表示新匯入的原始來源與目前修訂相同。目前版本會跳過它，而不是建立重複修訂。
第二次成功了，還需要記錄嗎？¶
要。間歇性失敗對穩定性評估仍然重要。