Jira 搬家實務指南：CSV 匯出完整教學、四個欄位對映坑與試搬驗證法

2024 年 2 月 Jira Server 停止支援之後，我收到的搬家詢問明顯變多。最常見的開場白是：「我們已經決定要走了，但 Jira 裡那堆資料怎麼辦？」

Jira 匯出 CSV 這件事，動手前看起來像十分鐘的工作，動手後通常變成兩個下午。去年我陪一個 22 人的遊戲後端團隊搬家：4,800 筆 issue、11GB 附件，第一次匯出的 CSV 用 Excel 打開全是亂碼，PM 當場問我「是不是資料壞了」。沒壞，是編碼的坑，後面會講。

這篇是工具中立的實務教學。不管你要搬去 Plane、OpenProject、Worklenz，還是我自己做的 LIVO，步驟都一樣：盤點、匯出、對映、試搬、全量。照這個順序走，翻車機率會低很多。

搬家前先盤點：你要搬的不只是資料

先別急著按匯出。我看過的失敗搬遷，八成敗在「不知道自己有什麼」。花一個小時做盤點，至少弄清楚這五件事：

• 專案數與 issue 總量：決定要切幾批匯出，也決定搬家要排幾天。
• 實際有值的自訂欄位：去 Jira 管理後台把自訂欄位列出來，逐一確認哪些真的有人在填。通常比你以為的少一半。
• 每個專案的工作流狀態清單：這是後面對映表的原料。
• 附件總量與存放位置：直接影響你的附件策略（下一節細講）。
• 整合與自動化：Slack 通知、Automation 規則、市集外掛。這些完全不會跟著 CSV 走，要另外重建或放棄。

盤點時順便做一個決定：要不要搬歷史資料。我的建議是結案超過一年的不搬，匯出 CSV 存檔就好。那個 22 人團隊最後只搬了 1,900 筆進行中與近一年的任務，「全部都要搬」的執念在盤點會議上就放下了，後面每一步都因此輕鬆一半。

Jira CSV 匯出完整步驟（以 Jira Cloud 為例）

第一步：用 JQL 圈出範圍

進 Jira 的 Filters、選 Advanced issue search，用 JQL 圈出要搬的範圍，例如 project = GAME AND created >= 2025-07-01 ORDER BY created ASC。

ORDER BY created ASC 不是裝飾，等一下切批次要靠它對齊，先養成習慣。

第二步：選「Export Excel CSV (all fields)」

右上角匯出選單有兩種 CSV：current fields 只匯出你畫面上顯示的欄位，all fields 才會把自訂欄位、註解、附件連結全部帶出來。搬家一律選 all fields。

這裡就是開頭那個亂碼坑：中文內容的 CSV 用 Excel 直接雙擊開啟會變亂碼。不是資料壞了，是 Excel 對 UTF-8 編碼的預設判斷問題。改用 Google Sheets 匯入，或在 Excel 走「資料、從文字/CSV」並指定 UTF-8，就會正常顯示。

另一個心理準備：all fields 匯出來的 CSV 會有上百個欄位，每一則註解、每一個附件連結都佔獨立一欄，第一次打開很壯觀。先原封不動存一份原始檔，再另存一份工作版去刪欄位，之後改壞了才有得救。

第三步：處理 1,000 筆上限

Jira Cloud 的介面匯出單次上限 1,000 筆。超過就用建立日期把 JQL 切段，例如一季一段，逐批匯出再合併。4,800 筆切五、六批，半小時內做得完，不需要寫程式。

合併後用 issue key 排序檢查頭尾。兩批的日期範圍如果重疊，就會出現重複列；有空窗，就會漏資料。這一步花五分鐘，能省掉全量匯入後才發現少了三百筆的慘劇。

四個一定會踩的欄位對映坑

坑一：自訂欄位

Jira 允許不同專案有同名的自訂欄位，匯出後 CSV 會出現兩個一模一樣的欄位標題，匯入工具分不出哪個是哪個。匯出後先打開檔案掃一眼標題列，同名欄位手動改名。

另外，目標工具的欄位型別不一定跟 Jira 對得上。下拉選單、多選、日期、數字這些常見型別大多沒問題，但 Jira 的串聯選單（cascading select）幾乎沒有工具能直接吃，得拆成兩個欄位。動手前先查清楚目標工具支援哪幾種型別（以 LIVO 為例是 7 種），別假設對面什麼都收。

坑二：附件不會跟著走

這是最多人誤會的一點：CSV 裡的附件欄位只有「網址」，不是檔案本身。而且那些網址要登入 Jira 才打得開——等你退租，連結全部失效。

三個務實的選項：一，請工程師寫腳本用 API 把附件抓下來，大約半天的工作量；二，把 Jira 降到最低授權當唯讀檔案庫，放三到六個月再退；三，接受附件不搬，重要檔案人工救援。那個 22 人團隊選了第二條路，11GB 附件一個都沒搬，三個月觀察期內真的回去撈檔案的次數：4 次。

坑三：子任務階層

CSV 裡的母子關係靠 Issue id 和 Parent id 兩個欄位串起來。問題是很多工具匯入時只認任務列表，不認這兩欄，匯進去階層全部變平的，上百個子任務跟母任務失聯。

匯入前先確認目標工具怎麼處理 Parent id。如果不支援，比較不痛的做法是先把子任務標題加上母任務編號前綴（例如「[GAME-102] 修排行榜快取」），至少之後搜尋得回來。

坑四：狀態對映

用了三年 Jira 的團隊，工作流通常長到不敢直視。我看過一個專案有 14 個狀態，其中包括「等待 QA 二次確認」和「等待 QA 二次確認（美術）」。而目標工具的看板通常只有四到六欄，硬塞是塞不進去的。

匯入前先做一張對映表，跟團隊過一遍再動手：

對映表的重點不是技術，是共識。「Blocked 算進行中還是待辦」這種問題，匯入前吵完，比匯入後吵便宜十倍。

試搬驗證法：先搬 50 筆，再談全量

不管目標工具的匯入功能宣稱多聰明，先搬 50 筆。而且不是隨便抓前 50 筆——要故意挑「最難搬的 50 筆」：有子任務的、自訂欄位填滿的、描述裡有中文表格和程式碼區塊的、掛了十幾則註解的、已結案的，各抓一些。

匯入後核對五件事：日期有沒有錯置（03/07 是 3 月 7 還是 7 月 3，取決於 Jira 的語系設定，這個坑中過的人都懂）、負責人有沒有對到人、狀態有沒有照對映表走、母子階層有沒有斷、中文有沒有變亂碼。50 筆大約核對 40 分鐘，能擋掉九成的全量災難。

兩個容易漏掉的欄位也順手查一下：Sprint 匯出後只剩文字名稱，衝刺的起訖日期不會跟著走；工時欄位（estimate 與 time spent）匯出來是秒數，8 小時會變成 28800，目標工具沒有自動換算的話得自己處理。

順帶一提，我把這個流程直接做進了 LIVO：標準版就能免費試匯預覽，把對映結果先攤開來核對，確認沒問題，再用專業版跑完整匯入。這不是什麼創新，只是把「本來就該這樣做的事」變成產品的預設路徑。你搬去任何其他工具，也請手動堅持這個順序。

常見翻車點，以及什麼時候不該搬

幾個我實際看過的翻車現場。有人匯入按了兩次，9,600 筆重複任務，而目標工具沒有批次刪除，手刪了一整晚——匯入前先確認工具能不能整批復原或清空。有人在 Sprint 進行中搬家，一半的人看 Jira、一半看新工具，燃盡圖兩邊都不準——搬家日請訂在 Sprint 結束後的空檔。還有人用顯示名稱對映使用者，結果團隊裡有兩位「阿哲」，任務全指派給了資深的那位，資淺的那位爽了一週。用 email 對映，不要用名字。順便提醒：離職成員的任務別急著改指派，先原樣搬過去，歷史紀錄上「這段程式當年是誰動的」比你想的有價值。

然後是比較少人願意講的：有些情況你根本不該搬。如果團隊重度依賴 Jira Automation、Advanced Roadmaps 或某個市集外掛，重建這些的成本可能超過訂閱費省下的錢，留在 Jira 是理性的。如果只是嫌貴，也可以先評估 Plane CE、Worklenz、Leantime、OpenProject CE 這些免費開源自架方案——只要團隊有人能維護 Docker，它們是零授權費的正解，我自己賣買斷工具，也得承認這一點。

LIVO 的定位很直白：繁中原生、審批流和自動日報內建、中文文件加 LINE 支援、出問題找得到人（就是我本人）。代價是閉源、生態小、開發者只有一個。這些條件對你重要，再考慮它；不重要，開源方案搬過去一樣能用。

常見問題

Jira 匯出 CSV 有筆數限制嗎？

Jira Cloud 介面匯出單次上限 1,000 筆。超過就用 JQL 依建立日期切段分批匯出，合併時注意日期範圍不能重疊也不能有空窗，最後用 issue key 排序檢查重複與遺漏。

附件可以跟著 CSV 一起搬嗎？

不行。CSV 只包含附件的網址，而且需要 Jira 登入權限才能存取，退租後全部失效。務實做法是請工程師用 API 腳本下載，或保留 Jira 最低授權當唯讀檔案庫三到六個月，確認沒人回頭撈檔再退。

一定要一次把所有專案搬完嗎？

不用，也不建議。先搬一個進行中的專案跑兩週，對映規則和團隊習慣都順了，再搬其他專案。結案超過一年的歷史任務留 CSV 存檔即可，不必進新工具。

如果想先看看 Jira 資料匯進新工具後長什麼樣子，LIVO 有免登入的線上 Demo，打開就能玩；想拿自己的 CSV 實際試一輪，也有 14 天免費試用（自架、給的是專業版金鑰）。搬不搬，之後再說。