Excel to JSON API 的替代方案可以將本機 .xlsx 檔案中最多 20 MB 的單一工作表轉換成可下載的 JSON 檔案，且無需上傳活頁簿。
Excel to JSON Converter 為開發人員提供以瀏覽器為基礎的檔案對檔案工作流程，適合收到試算表資料，但需要 JSON 記錄供指令碼、靜態資料檔、開發工具或應用程式匯入流程使用的情況。
這是代用托管式轉換步驟的替代方案，而非即時 API 端點。它會建立 JSON 下載檔，且不會變更原始活頁簿。
本機 API 替代方案涵蓋的範圍
首先必須區分可下載的轉換與可呼叫的服務。托管式 Excel-to-JSON API 接受請求並傳回回應，讓其他系統能在執行階段觸發轉換。這個轉換器則是接受本機活頁簿，並產生本機 JSON 檔案，供使用者檢查及使用。
這個頁面會在目前的瀏覽器分頁中執行。它會讀取試算表封裝的資料、建立可下載的 JSON Blob，且不會將活頁簿上傳至轉換伺服器。檔案不會排入遠端處理佇列、不會由工具保留，也不會在磁碟上變更。
因此，當試算表是來源格式，但目的地工作流程需要 JSON 時，這個工具就很合適。它也為自動化作業清楚劃定了界線：當程式碼必須在執行階段反覆要求轉換時，應使用程式庫或服務，而不是將手動下載視為 API 整合。
在本機將 Excel 工作表轉換為 JSON
若要處理單一本機活頁簿及結構清楚的工作表，請使用下列工作流程。
- 選擇活頁簿。開啟 Excel to JSON Converter，並選擇一個大小不超過 20 MB 的本機 .xlsx 檔案。請使用一般的 .xlsx 活頁簿，而非舊版、含巨集、密碼保護或遠端檔案。
- 選擇一個工作表。選擇包含所需記錄的工作表。只有所選工作表會匯出，因此不會將無關的工作表合併到結果中。
- 檢查標題列。第一個非空列必須包含欄位名稱。每個標題都必须非空且唯一，因為重複的 JSON 鍵可能會覆寫物件中的資料。如果來源沒有清楚的標題列，請先在試算表中準備好。
- 執行轉換。對所選工作表啟動轉換。工具會讀取儲存的儲存格值，並將各列序列化為 JSON 記錄。
- 下載 JSON。儲存產生的 JSON 檔案。這是一個新的輸出檔案，不會取代或修改原始活頁簿。
- 檢查記錄。在傳送至其他位置之前，先開啟下載檔一次。將欄位名稱、null 值、公式、日期及整體記錄結構與目的地系統的預期內容進行比對。
如果公式儲存格必須包含目前的計算結果，請先在試算表應用程式中重新計算並儲存活頁簿，再進行轉換。轉換器會匯出檔案中已儲存的值，不會在瀏覽器中執行公式。
Excel 列如何對應至 JSON 記錄
所選工作表會被解讀為以標題列為基礎的資料，而不是視覺化試算表的複本。瞭解這種對應方式，可讓輸出在進入其他工作流程之前更容易稽核。
| 試算表輸入 | JSON 結果 | 重要界線 |
|---|---|---|
| 第一個非空列 | 欄位名稱鍵 | 每個標題都必须非空且唯一。 |
| 後續的每一列 | 一筆 JSON 記錄 | 只會包含所選工作表。 |
| 空白儲存格 | null | 工具不會以猜測值填補空缺。 |
| 已儲存的文字、數字或 Boolean | 一般 JSON 值 | 會保留已儲存的值，而不會將其標準化。 |
| 公式儲存格 | 其已儲存的值 | 不會在瀏覽器中進行公式計算。 |
標題會成為每筆記錄中的鍵，而值則保留其已儲存的 JSON 類型。日期可能會維持為活頁簿所保存的數值，因為轉換器不會猜測語系或日期意圖。在假設其他應用程式會以相同方式顯示這些值之前，請先檢查這類值。
輸出包含的是記錄，而不是試算表的呈現內容。轉換器不會推斷巢狀物件、合併多個活頁簿、修復來源資料，也不會根據商業結構描述規格驗證記錄。
可能會停止匯出的限制
可接受的輸入範圍刻意設得很窄。轉換器支援 .xlsx OOXML 活頁簿，但不含舊版 .xls 檔案、含巨集格式、密碼保護的活頁簿或雲端 URL。所選工作表也必須維持在 100,000 個可定址儲存格以內。
在剖析活頁簿之前，這個頁面會檢查傳統 ZIP 目錄，並強制套用 20 MB 的來源檔案大小限制。它會拒絕不受支援的 Zip64 或多磁碟套件，也會限制宣告的展開套件大小及項目數量。這些檢查可降低意外造成瀏覽器記憶體壓力的情況，但並不保證每個小型活頁簿都能輕鬆剖析。
損毀、加密、體積過大或不受支援的活頁簿會在產生部分下載檔之前停止並回報錯誤。如果轉換失敗，請勿將不完整的輸出視為可用的 JSON 交接資料。
工具只會讀取已儲存的值，不會執行公式、巨集、外部連結、指令碼或內嵌內容。格式、欄寬、條件式格式、圖表、圖片、註解、篩選器、列印設定、活頁簿保護、具名範圍及公式來源文字都不在匯出範圍內。此處的 JSON 是資料表示法，而不是試算表的複製版本。
檔案匯出與即時 API 的選擇
「替代方案」一詞需要界定正確的範圍。這個轉換器適合本機、以檔案為基礎的資料交接；但不會重現與 API 型整合相關的所有功能。
| 目標 | 與這個轉換器的適合程度 | 限制或後續步驟 |
|---|---|---|
| 從單一試算表工作表建立 JSON | 支援本機工作流程 | 會產生可供手動使用的可下載檔案。 |
| 提供即時轉換端點 | 不提供 | 請使用實際的服務或程式碼函式庫。 |
| 執行週期性同步 | 不提供 | 需要獨立的協調作業。 |
| 產生巢狀記錄 | 不會推斷 | 請另外準備所需的結構。 |
| 強制套用應用程式結構描述規格 | 不執行 | 請在目的地工作流程中驗證記錄。 |
| 從 URL 轉換活頁簿 | 不接受 | 請先取得本機 .xlsx 檔案。 |
若是一次性的開發人員交接，JSON 下載檔可以成為靜態資料成品，或成為本機指令碼所消耗的輸入。對於完全由程式碼控制的資料管線，則更適合使用程式化途徑，例如在本機使用 Python 將 Excel 轉換為 JSON。
這個轉換器只會在產生檔案後停止。它不會將記錄傳送至端點、合併其他來源，也不保證接收端應用程式會以完全相同的方式解讀每個 JSON 值。
準備乾淨且可稽核的交接資料
轉換前，請準備最小且相關的工作表，並讓欄位容易驗證。
- 使用穩定且具描述性的標題名稱，並移除空白或重複的標題。
- 檢查來源儲存格為空時所對應的 null 值。
- 當已儲存的值很重要時，請檢查公式儲存格。
- 確認目的地預期的是數值日期或其他表示方式。
- 保留原始活頁簿，作為正式紀錄來源。
如果轉換前需要進行格式設定或視覺檢查，請使用 Excel Viewer Online 進行視覺檢查。
下載 JSON 之後，請先檢查記錄，再與其他系統分享。這個轉換器的文件不涵蓋所連結的 JSON Formatter 與 JSON Validator，因此在依賴它們之前，請獨立驗證其行為。檢查記錄無法取代商業結構描述規格驗證，也不能確認目的地應用程式會如預期處理每個值。
若要取得可靠的結果，請轉換準備好的工作表、檢查記錄一次，並另外保留活頁簿。這個瀏覽器轉換器提供透明的本機匯出，但不會合併活頁簿、將值標準化、推斷巢狀物件、修復公式、抓取遠端試算表，也不會將下載檔變成即時 API。