需要把文件存放在伺服器並進入協同編輯流程，優先評估 unitId；只做本地或離線處理、格式轉換，則優先評估 Snapshot。本文依使用場景比較兩條流程，並提供後端設定與工作簿往返驗收清單。
官方 Import and export 文件說明了以 unitId 載入文件，以及以 Snapshot 處理工作簿資料的不同路徑。因此，Univer 匯入匯出應依文件是否需要伺服器持久化與協同編輯來選：需要持續保存、多人協作，優先選 unitId；只需本地或離線處理、格式轉換，優先選 Snapshot。兩條路徑都要先確認轉換後端可用，並實際驗收匯出檔案。
這篇適合正在替 SaaS 串接 Univer Sheets 的前端、全端工程師，以及負責文件工作流程的產品技術團隊。
如果目前只做離線處理或格式轉換，請特別留意 Snapshot 的資料邊界，以及匯出仍需要的後端能力。
先按文件生命週期選路徑
別只問「要不要協同編輯」，還要先確認文件由誰保存、之後是否會重新載入，以及匯出由哪一層負責。這些條件會改變資料流，也會決定要驗收哪些服務。
需要伺服器持久化與協同文件時，選 unitId
匯入文件後，流程會取得文件對應的 unitId，再由協同環境依這個識別碼載入文件。它適合文件要留存在服務端，並需要透過協同機制持續開啟、編輯與再次匯出的 SaaS。
unitId 是文件識別資訊，不是儲存服務本身，也不會自動替專案完成權限控管或資料保存。實作時應檢查匯入服務如何寫入文件、前端載入時如何取得存取權，以及使用者修改後如何保存並再次匯出。Univer 的協同模組說明與服務端文件可用來核對協同和伺服器端的責任範圍；實際接線仍須配合專案採用的 SDK 與服務端版本。
只在本地或離線處理時，評估 Snapshot
Snapshot 路徑以工作簿資料作為匯入與匯出的依據：匯入後取得工作簿資料，處理完成後再以快照資料產生檔案。它適合一次性轉換、離線整理，或不需要協同文件識別碼的工具；使用 Snapshot 不等於必須開啟協同編輯。
但 Snapshot 也不是免除服務端工作的捷徑。官方匯入匯出說明仍要求配合檔案轉換後端；若轉換端未部署、版本不符或輸入輸出格式未核實，前端能讀取工作簿資料，不代表最後一定能產生預期檔案。可以先對照服務端匯入匯出架構，確認轉換工作由哪個服務承接。
XLSX 匯入該怎麼在 unitId 與 Snapshot 之間選？
以後續使用方式決定，而不是只看來源副檔名。同一份 XLSX，若匯入後成為 SaaS 中可持續開啟、保存並協同編輯的文件，應先測試 unitId 路徑；若目標是讀取資料、轉換內容，再輸出檔案，且沒有協同文件生命週期，則先測試 Snapshot 路徑。
兩種設計的責任不同：前者需要把文件識別、伺服器持久化、存取權與協同載入串起來；後者要確保快照資料能交給轉換端，並從輸出檔反向驗證內容。若產品同時提供「持續編輯」與「批次轉檔」，不要勉強用單一路徑涵蓋兩者，應分別驗收。
把 CSV／TSV 限定為表格資料轉換
CSV 或 TSV 可以承載以分隔符號排列的表格資料，但不能像 XLSX 工作簿一樣保存多個工作表的結構，也不承載完整的儲存格格式、圖片等工作簿內容。即使把資料成功讀入 Univer，這也不能視為完整工作簿往返：來源中不屬於純文字表格的資訊，可能無法由這類格式保留。
導入前要核對目前使用版本的格式支援，以及實際呼叫的 API 接受哪種輸入、會輸出哪種檔案。尤其要確認分隔符號、文字編碼、標題列與空值如何處理；匯出時則檢查公式是以公式文字還是計算結果呈現，不能只因檔案能開啟，就推定資料語意與原表一致。CSV／TSV 的轉換適合明確限定為單一表格資料的情境，不應宣稱具備多工作表、格式與圖片的完整保留能力。
Snapshot 匯出 XLSX 為何仍要轉換後端？
Snapshot 提供工作簿資料，不是 XLSX 檔案本身。要將工作簿資料編碼成可交付的檔案，仍須使用官方文件所述的檔案轉換能力；因此，前端能取得或修改 Snapshot，並不能代替轉換服務。請依官方匯入匯出說明核對當前版本的流程，再以快速入門中的資料保存方式確認專案自己的保存責任，避免把前端狀態誤當成已持久化文件。
第一步：依資料流逐項驗收
選定路徑後，先用產品實際會收到的工作簿測試，而不是只用空白範例。Univer 對工作簿及工作表的資料結構，可參考Sheets API 文件；公式則可對照公式功能文件。文件能說明支援的概念，但公式結果、圖片與複雜格式在你的版本和環境中是否如預期，仍須由測試確認。
- [ ] 確認輸入與輸出格式：列出產品實際接受及產生的格式，對照目前 SDK、服務端版本與官方支援說明；不要把一種格式的成功匯入推論成所有格式都可匯出。
- [ ] 驗證多工作表：準備包含多個工作表的樣本，記錄匯入後的工作表名稱、次序與資料範圍，再檢查匯出檔是否保留預期內容。
- [ ] 分開記錄公式與計算結果：選取會引用其他儲存格的公式，分別檢查公式文字是否存在、結果是否符合預期。若使用的公式或計算行為有版本限制，應記下差異，而非概括宣稱公式都相容。
- [ ] 檢查圖片及格式：挑選含圖片、合併儲存格、日期或數字格式的真實樣本，比較匯入前後與再次匯出後的呈現；對任何變化都記錄具體儲存格或工作表位置。
- [ ] 走完保存與再載入：unitId 流程要測試保存後以識別碼再次載入，以及文件存取權是否正確；Snapshot 流程則要驗證轉換端接收的快照與最終輸出檔都符合預期。
- [ ] 使用目標使用者檔案複測：納入產品實際會收到的檔案，分別記錄公式計算、格式變化及檔案相容性。這三項是不同驗收結果，不要用「檔案成功下載」代替。
若測試中出現差異，先定位在匯入解析、工作簿資料、伺服器保存，還是匯出轉換。這樣能避免只調整前端載入流程，卻漏掉真正負責生成檔案的服務端環節。
依場景對照成本與責任
下表不是功能優劣排名，而是用來判斷哪一條資料流更符合產品需求。格式支援細節可能隨版本調整，應回到官方文件與目標環境核對。
| 判斷項目 | unitId 路徑 | Snapshot 路徑 |
|---|---|---|
| 適合的文件生命週期 | 伺服器持久化、再次載入與協同編輯 | 本地或離線處理、一次性轉換 |
| 主要資料依據 | 匯入後取得的文件識別碼 | 匯入所得的工作簿資料 |
| 協同需求 | 適用於需要接入協同文件流程的情境 | 不以協同編輯為前提 |
| 必須驗收的環節 | 服務端保存、文件存取、協同載入、再次匯出 | 快照內容、轉換端輸入、檔案輸出 |
| 常見誤判 | 把 unitId 當成自動完成保存與權限設定 | 把 Snapshot 當成不需轉換後端，或等同完整保留 XLSX 所有內容 |
落地前，請將預期的保存責任、匯出格式與驗收結果寫進技術方案；如果團隊也要評估開發環境，可先從 nuvcloud 的 Mac mini 方案資訊比較臨時測試環境與自備設備的取捨。Mac 並非 Univer 匯入匯出的必要條件，真正需要確認的仍是文件轉換服務與目標部署環境是否匹配。
為文件工作流選擇合適的測試環境
如果目前依賴開發者各自的本機環境，常見問題包括軟體版本不一致、多人重現失敗情境不易，以及前端與轉換服務缺少共同驗收環境；改用一般雲端環境，也要核對作業系統、瀏覽器與服務端部署條件是否符合團隊測試方式。這些都是環境管理上的取捨，不代表改用 Mac 就會自動解決文件相容性。
當需要短期測試 macOS 瀏覽器行為、統一團隊開發環境，或在專案中驗證前端與文件服務的連線時，租用 nuvcloud 的 Mac 可以作為自備設備之外的選項；若工作負載長期固定、需要實體介面，或不涉及 macOS 測試，自購設備或現有伺服器可能更合適。準備評估臨時環境時，可先查看 nuvcloud 的 Mac 使用與服務說明，再依文件保存、轉換服務與測試需求決定，不必把硬體選擇誤當成 unitId 或 Snapshot 的替代方案。
把匯入匯出流程，放到穩定的遠端 Mac 驗收
透過 nuvcloud 租用獨享裸金屬 Mac，讓您在獨立環境執行文件處理與往返驗收。
提供 SSH 與 VNC 連線，既可遠端操作桌面，也能從命令列整合工作流程。