移轉指南 - Anki 匯入 JSON
如何將 JSON 卡片資料匯入 Deckbase
JSON 是結構化資料的共通語言。如果你的卡片存放在 API、資料庫或自訂應用程式中，本指南可協助你精準地將 JSON 欄位對應到 Deckbase 卡片。
Deckbase閱讀時間 7 分鐘
何時使用這套流程
適合從自訂工具、API 或程式化卡片產生器移轉，且需要在匯入時進行結構描述層級控制的開發人員與進階使用者。
請把這視為一套可操作的搬移流程，而不是一次性的檔案上傳。目標不只是匯入成功，還要在轉換後的幾週內維持更好的複習一致性，並降低卡片維護成本。
匯入前檢查清單
- JSON 檔案採用物件陣列，且所有物件的正面與背面鍵保持一致。
- 字串為有效的 UTF-8，且不含未跳脫的控制字元。
- 標籤與筆記等選用欄位在所有物件中使用可預期的鍵。
只要有一項檢查清單未通過，請先修正再匯入。事前整理比匯入後修補數百張卡片快得多。
逐步搬移流程
- 1使用 linter 驗證 JSON 結構，並確認每個物件都含有必要的正面與背面鍵。
- 2決定對應方式：哪些鍵會成為卡片的正面、背面、標籤與筆記。
- 3先用 10 個物件執行小型測試匯入，並檢查卡片呈現結果。
- 4修正編碼問題，或處理巢狀物件扁平化錯誤的情況。
- 5匯入完整資料集，並確認卡片總數與預期列數相符。
常見錯誤與修正
巢狀物件被扁平化成 [object Object]
匯入前先將巢狀欄位預先處理成純字串。
Unicode 跳脫序列未顯示
上傳前將 \uXXXX 跳脫序列轉換成實際的 Unicode 字元。
部分物件缺少必要鍵
篩選或修補不完整的物件，確保每張卡片都有正面與背面。
欄位內的陣列被當成字串處理
用逗號串接陣列值，或拆成個別的標籤項目。
每次修正後，先用一個小型測試牌組驗證。若測試品質穩定，再把同樣的修正方式套用到整批資料。
範例輸出品質檢查
- 正面：什麼是 JSON Schema？ | 背面：用來定義 JSON 文件有效結構的詞彙集。
- 正面：JSON 陣列與物件有何不同？ | 背面：陣列是有序清單；物件是無序的鍵值集合。
- 正面：為什麼匯入前要驗證 JSON？ | 背面：及早驗證可避免格式錯誤的卡片，以及大規模匯入時失敗。
品管時，請逐張檢查範例卡片是否清楚、是否只考一個重點，以及答案是否精準。不要匯入只測措辭、不測理解的卡片。
實用測試法：若複習時能在 10 秒內正確回答，通常代表這張卡片的範圍拿捏得不錯；若不行，就拆分或改寫。
常見問題
我可以直接從 REST API 匯入 JSON 嗎？
先將 API 回應存成 .json 檔案、驗證內容，再匯入 Deckbase。
如果我的 JSON 使用 camelCase，而 Deckbase 預期 snake_case 怎麼辦？
匯入時明確對應鍵值；欄位名稱不必完全一致。
支援大型 JSON 檔案嗎？
支援，但建議先以小量資料測試，確認結構描述對齊與呈現結果。
將結構化 JSON 資料匯入 Deckbase
先對應一次結構描述，透過小型試行驗證，再移轉完整的卡片庫。
提示：進階流程請保留原始匯出檔作為備份，並以批次名稱和日期記錄每一次搬移嘗試。
鎖定的搜尋意圖：Anki 匯入 JSON。本指南以實用搬移流程頁的角度撰寫與檢視，並非一般性知識文章。