檢查甘特圖的結果並不是一個獨立的工具、獨立的上傳動作或獨立的報告:驅動螢幕上預覽的 SVG 字串,與建構成下載檔案的字串是同一個,因此你在瀏覽器中看到的內容,與你儲存的內容完全一致。在 甘特圖製作工具 中,這種預覽與下載的對應關係是刻意設計的,也決定了結果審查的方式。一旦產生成功,頁面上的圖表就是交付出去的圖表,這代表每一個視覺決策——長條位置、長條寬度、刻度密度、標籤內容、座標軸範圍——都是你在匯出前(而非匯出後)就能驗證的項目。

驗證步驟很重要,因為甘特圖很容易被誤讀。一個提早一天開始的長條、把一整年壓縮成少數幾個標籤的座標軸,或是本應顯示為日期卻被算繪成數字的標籤,都可能悄悄地被帶進簡報、列印資料或交接文件中。在下載前快速檢查一遍,能把這些沉默的錯誤轉為可見的錯誤,並確保匯出的檔案內容誠實可靠。本指南會逐步說明該檢視哪些項目、依什麼順序檢查,以及為什麼螢幕上的預覽是你儲存檔案的唯一真實來源。

how do i check the result after i make gantt chart
如何在製作甘特圖後檢查結果

這裡所說的「檢查結果」實際上代表什麼

對甘特圖而言,「檢查結果」通常指以下兩件事之一:一是健全性檢查,確認長條、日期與標籤能反映你輸入的排程;二是合適性檢查,確認圖表能充分傳達時間軸,方便分享。一張以嚴格的 YYYY-MM-DD 工作項目列、含首尾日期、安全的 SVG 標籤,以及日或月刻度所建構的甘特圖,會把這兩種檢查合併為同一個可見的成品。沒有隱藏的報告、沒有附屬的表格、也沒有側邊面板;算繪出來的 SVG 就是完整的輸出。

這種設計帶來兩個實際的影響。第一,你想要確認的每一個值都在畫布上:頂部的標題、左側的工作項目標籤、橫跨日曆座標軸的長條起訖位置,以及頂端的刻度標籤。第二,由於圖表是根據已驗證的輸入(而非需詮釋的輸入)所產生,成功的算繪本身就是一種檢查——每一列在語法上都有效、每個日期都是實際的預拓格里曆 UTC 日曆日期,且每個結束日期都在其對應開始日期當天或之後。檢查即圖表,圖表即檔案。

依照七個具體步驟審查算繪後的圖表

開啟工具並依序執行下列步驟。目標是在儲存之前,確認長條、刻度與標籤與你預期的排程一致。

  1. 新增一個選用標題,並貼上 2 到 30 列非空白的工作項目,開始,結束資料列。每一非空白列必須恰好包含兩個原文逗號,劃分為三個欄位:工作項目標籤、開始日期與結束日期。
  2. 確認每個日期都採用精確的 YYYY-MM-DD 格式,並使用真實的 UTC 日曆值。四位數、一個連字號、兩位數月份、一個連字號,以及兩位數日期——不得使用斜線、時間文字或時區後綴。
  3. 點擊「產生」。若任何一列格式錯誤,整個請求將被拒絕,且不會出現部分圖表;若預覽成功算繪,代表每一列都被接受。
  4. 閱讀預覽頂部的標題,接著閱讀左側邊緣的工作項目標籤,確認其依序(含任何重複項目)與你的輸入相符。
  5. 由左至右檢視長條。每個長條的左側邊緣應對齊其開始日期,右側邊緣應對齊其含首尾的結束日期。一個 1 月 1 日到 1 月 3 日的工作佔據三個日期儲存格,而一個同日的工作則佔據一個。
  6. 閱讀頂端座標軸上的刻度標籤。排程為 62 天或更短時使用決定性的日刻度;更長的排程則切換為月刻度。日刻度間距會自動調整,以維持大約九個標籤,同時一定會包含第一個與最後一個日期。
  7. 當長條、刻度與標籤全部對齊後,點擊下載動作,將剛才審查過的同一個字串所建構的獨立 SVG 儲存下來。

為什麼預覽與下載的 SVG 會一致

預覽並非圖表的簡化版本,下載也非重新算繪的複本。兩者都是在同一個瀏覽器分頁中,由同一個 SVG 字串所產生。甘特圖製作工具只組合一次 SVG,在頁面上顯示,並在你點擊下載時——將同一字串封裝為 Blob,並觸發同原錨點下載。一旦標題或資料變更、結果被取代、產生失敗,或元件卸載,該 Blob URL 便會立即被撤銷,因此你不會遇到過期的預覽與較新的檔案並存的情況。

這對驗證很重要,因為它消除了整整一類的疑慮。你不需要在另一個檢視器中重新開啟下載檔案來確認長條是否與你審查過的相同,也不需要將儲存的檔案與預覽逐像素比對。螢幕上的圖表就是檔案,依據 W3C SVG 2 詞彙定義,具有固定的 1,100 像素邏輯寬度、依列數而定的動態高度、白色背景、格線、標籤文字,以及無障礙角色與標籤屬性。你若能讀懂它,便能儲存它;若無法讀懂,則還不需要按下下載按鈕。

在儲存之前先讀懂長條、刻度與標籤

幾個快速的視覺檢查能在錯誤離開頁面前抓出大部分的甘特圖問題。請利用下列對照表判斷座標軸是否符合你的預期:

排程長度刻度模式刻度標籤格式使用此模式的原因
62 天或更短日刻度YYYY-MM-DD日刻度間距會自動調整,以維持大約九個標籤,同時一定會包含第一個與最後一個日期。
63 天或更長固定步進的月刻度YYYY-MM數以千計的日標籤會擠爆座標軸;因此改用根據總月數計算的固定月步進。

一旦座標軸處於正確的模式,長條本身就值得再看一眼。長條位置是最早開始日的整數 UTC 天數偏移量,寬度則是各工作項目的含首尾天數,因此當長條看起來少了一格,通常代表來源列中的結束日期少算了一天。若要手動驗證含首尾區間,請使用簡單公式:含首尾天數 = 結束日數字 − 開始日數字 + 1。舉例來說,一列 Wireframe,2025-01-01,2025-01-03 的含首尾天數 = 3 − 1 + 1 = 3 個日期儲存格;而一列 Launch,2025-03-15,2025-03-15 的含首尾天數 = 0 + 1 = 1 個日期儲存格。如果預覽中的長條與該數量不符,應修正輸入而非圖表。

最後要確認的是標籤文字。工作項目標籤、選用的標題以及工具提示文字,都已跳脫為安全的 SVG 文字(而非解析為標記),因此來源列中的 & 符號、角括號、引號或撇號,會以你輸入的字元顯示,而不會變成多餘的元素。圖表僅描述日曆佔用情況——不會顯示時數、工作天、努力程度、完成百分比或資源容量——因此若結果在上述任何面向看起來「不對」,實際上是工具在告訴你:對於那個問題,它不是合適的工具。

將通過驗證的圖表下載為獨立的 SVG

一旦預覽通過你的審查,下載步驟可說是整個工作流程中最單純的部分。該檔案是一個獨立的 SVG,沒有外部字型、遠端圖片或 script 標籤;W3C 命名空間、viewBox、角色與無障礙標籤全都寫入你審查過的同一個字串中。解析、UTC 日期運算、SVG 建構、預覽算繪以及 Blob 下載全部都在當前的瀏覽器分頁內完成,因此排程從不離開裝置。

如果日後的執行產生的圖表過大,無法在 100,000 個程式碼單位的輸出預算內序列化,請求便會失敗,且不會產生部分檔案——該上限是針對完整序列化後的字串進行檢查(而非抽樣),因此不會有下載內容被靜默截斷的風險。相同的邊界規則也適用於輸入:原始排程輸入上限為 20,000 個程式碼單位,標籤上限為 80,選用標題上限為 100,每項均視為單一上限進行檢查。另一方面,能在頁面上順利開啟的圖表,已通過上述所有檢查,而你儲存的檔案,就是你剛驗證之圖表的忠實複本。若想進一步閱讀在下載前抓出錯誤的相關內容,請參閱 製作甘特圖時避免犯錯。

若想深入了解,請參閱 選擇正確方法製作甘特圖。