若甘特圖看起來不正確,請修正來源列與日期、重新產生圖表,並在下載前於完全相同的預覽中檢查長條與刻度。
在 Gantt Chart Maker 中,通過驗證的資料會轉換成具決定性的 UTC 日曆圖表。令人意外的結果通常屬於三類之一:無效輸入、與預期日期不符的長條,或標籤經刻意抽樣的座標軸。

判斷您遇到的是哪一種錯誤結果
首先,請將產生失敗與外觀出乎意料的有效圖表區分開來。這可避免您只是為了讓版面呈現特定樣子,就更動有效的日期。
| 症狀 | 通常代表什麼 | 修正方式 |
|---|---|---|
| 未顯示圖表 | 某一列的語法無效、日期無效、結束日期早於開始日期,或超出大小限制。 | 修正整項要求後再次產生。此工具不會傳回部分圖表。 |
| 長條長度錯誤 | 預期期間與包含首尾在內的開始及結束日期不一致。 | 修正日期值,並記住結束日期會計入。 |
| 長條從非預期的日期開始 | 輸入的日期與預期的日曆日期不同。 | 檢查確切的 YYYY-MM-DD 值;通過驗證的 UTC 日期不會因瀏覽器的本地時區而位移。 |
| 座標軸標籤看起來很稀疏 | 長期排程使用抽樣的月份刻度,而非每天都有標籤。 | 在變更日期前,確認每項工作及其完整寬度都仍然存在。 |
| 預期中的工作或標籤遺失 | 工作未輸入,或其標籤與您預期的不同。 | 檢查來源清單。通過驗證的重複標籤與重疊工作,會依輸入順序保留為個別列。 |
請勿將缺少刻度標籤視為工作遺失的證據。長條幾何形狀與所印座標軸標籤的密度,是圖表中彼此不同的部分。
修正來源列
每項工作使用一列非空白資料,欄位順序為 task,start,end。每一列必須恰好包含兩個半形逗號,產生三個欄位。各欄位前後的空白會遭修剪。
- 不要加入完整 CSV 語法。不支援加上引號的欄位、引號內的逗號、跳出的分隔符號、額外欄位及多行欄位。需要逗號的工作標籤必須改寫為不含逗號的形式。
- 檢查列數。有效圖表需要 2 到 30 列非空工作資料。任一列格式錯誤,都會使整項要求遭到拒絕;剖析器不會默默略過該列。
- 檢查文字限制。工作標籤最多可包含 80 個 UTF-16 程式碼單位,選用標題最多可包含 100 個。原始排程資料最多可包含 20,000 個程式碼單位。恰好達到限制可通過驗證,但只要超過一個程式碼單位就會失敗,且不會截斷內容。
- 不要使用空白行來規避輸入限制。只有在檢查原始排程資料預算之後,空白行才會被忽略。
日期必須是真正的日曆日期,格式須恰好為 10 個字元的 YYYY-MM-DD,並使用 0000 到 9999 之間支援的年份。它們會依照正確的閏年規則,以推算前格里曆 UTC 日期進行驗證。斜線、缺少零填補、時間文字、時區後綴、不存在的日期,以及非閏年的 2 月 29 日都會導致失敗。每個結束日期都必須等於或晚於其開始日期。這種嚴格的日曆日期notation符合 ISO 8601 日期與時間格式。
正確解讀長條長度與刻度標籤
圖表描述的是日曆佔用情況。長條寬度與共用座標軸會依通過驗證的 UTC 日期計算,因此以下解讀可說明大多數視覺上的意外。
| 圖表特徵 | 正確解讀 |
|---|---|
| 長條寬度 | 從開始日期到結束日期(含首尾)的已佔用日曆天數。 |
| 開始與結束日期相同 | 工作佔用一個可見的日期儲存格。 |
| 共用水平範圍 | 從最早的開始日期起算,延伸至最晚的包含式結束日期隔天。 |
| 日刻度 | 跨度為 62 天或以下的排程會使用日標籤。間隔會擴大,以維持約九個標籤,同時保留第一與最後的日期。 |
| 月份刻度 | 較長的排程會使用依完整月份數計算出的固定月份步階,讓座標軸保持易讀,且不移除工作跨度。 |
| 重複標籤與重疊日期 | 它們會依原始輸入順序保留為個別工作。 |
日標籤使用 YYYY-MM-DD,月份標籤則使用 YYYY-MM。稀疏的月份標籤是刻意的座標軸抽樣,而非工作遭截斷。瀏覽器地區設定、目前日期、日光節約時間規則及本地時區都不會改變版面。如需深入了解包含式長條規則,請參閱 甘特圖長條的結束日期有算入嗎?。
在 Gantt Chart Maker 中修正圖表
- 列出預期工作。在每個非空行放置一項工作,並在輸入資料前找出其預期開始與結束日期。
- 加入標題並貼上各列。輸入選用標題,然後依 task,start,end 順序貼上排程。確認每一行恰好有兩個逗號。
- 修正每個日期。使用確切的 YYYY-MM-DD 值,移除任何時間或時區文字,並確認每個結束日期都等於或晚於其開始日期。
- 檢查標籤與大小限制。移除需要逗號的工作標籤中的逗號,確認列數介於 2 到 30 之間,並檢查標籤、標題及原始輸入限制。
- 選擇 Generate。若驗證拒絕該要求,請修訂來源資料,不要預期會得到部分圖表。格式錯誤的列不會產生任何結果。
- 檢查每個長條與刻度。依各工作的日期,檢查其起始位置與包含式寬度。確認重疊工作仍保持為個別項目,且稀疏的月份座標軸仍包含每個完整工作長條。
- 下載目前的預覽。只有在可見預覽正確後,才選擇獨立 SVG 下載。.downloaded檔案會依用於該預覽的完全相同 SVG 字串建立。
變更標題或排程後,請再次產生。當標題或資料變更、結果遭取代、產生失敗或工具關閉時,先前的 Blob 下載 URL 會失效,因此舊的下載連結可能無法再使用。
匯出前檢查算繪細節
有些問題會影響可讀性,而非日期計算。圖表使用固定的 1,100 像素邏輯寬度,高度則依列數而定。寬幅輸出會在預覽中水平捲動,而不是將標籤縮小成難以閱讀的行動版版面,因此在判定長條位置錯誤前,請先橫向捲動整張圖表。
- 工作與標題文字會逸出為安全的 SVG 文字。XML 不允許的控制字元與孤立的代理項目會轉為替代字元 U+FFFD。
- 看似指令碼的文字會保留為可見字元,而不會變成 SVG 元素。
- 完整序列化 SVG 最多可包含 100,000 個 UTF-16 程式碼單位。若超過限制,輸出便會失敗,而不會捨棄或抽樣標記。
- 若 Blob 或 URL 建立失敗,就不會留下過時的預覽或下載項目。
剖析、UTC 日期運算、SVG 建立、預覽與下載,全都在目前的瀏覽器分頁中進行。排程、標題、產生的 SVG 及互動內容都不會上傳至 Lizely。
瞭解哪些規劃缺口需要其他軟體
圖表可能在數學上完全正確,卻仍缺少您預期的資訊。此工具呈現的是包含首尾的日曆佔用情況,而非時數、工作日、工作投入、完成百分比或資源容量。
它無法剖析 Microsoft Project 檔案、相依關係、里程碑、關鍵路徑、假日、工作日曆、進度、負責人、成本、基準線或時區時間戳記,也不會推斷重疊工作是否可行。如果缺少這些功能正是結果看起來不正確的原因,變更日期列也無法新增它們。請使用專用的專案管理軟體進行相依關係規劃、協作、權限、稽核歷程及營運承諾管理。