Matplotlib 透過 plt.bar(x, height) 把一組類別標籤與數值清單轉成垂直長條圖,但只要把 2 到 30 筆嚴格的「標籤,數值」列貼進 Bar Chart Maker,再把預覽匯出成獨立的 SVG,就能不寫 Python 達到相同結果。這個瀏覽器工具把 import 陳述式、figure 呼叫與 savefig 那一行全部換成一顆 Generate 按鈕,接著產生一張 520 像素高的 SVG,採用固定的線性 y 軸、零基準線,以及五個等距的參考刻度。大多數搜尋 matplotlib 教學的人通常只想要三件事:把小型資料集快速變成看得到的圖、能夠預測地掌控長條與軸刻度的外觀,以及一個可以放進簡報、文件或網頁的可攜檔案。這個瀏覽器工具三項都能涵蓋,但有一個值得先說在前的取捨:它刻意做得很窄,只接受精簡版 CSV 列而非完整 CSV、只使用固定線性刻度而非 matplotlib 可選的對數刻度,並且完全在當前分頁中執行,而非透過 Python 直譯器執行。同一個匯出檔案同時驅動可見的預覽與 Blob 下載,因此你看到的內容就是實際存下的檔案。本文接下來會逐步說明這個工具接受什麼輸入、計算什麼內容,以及如何在下載前驗證 SVG。

matplotlib 對這份資料會畫出什麼
小型類別資料集的 matplotlib 路線大致如下。假設你有五個水果類別,銷售數量分別是 73、45、60、28 與 12。在典型的 matplotlib 腳本中,你會建立兩個平行的清單、呼叫 plt.bar(labels, values)、選擇性地用 ax.set_title(...) 加入標題,再用 plt.savefig("fruit_sales.svg") 存檔。預設行為會給你五條垂直長條、線性 y 軸、零基準線,以及數量不多的幾個參考刻度,其精確位置由 matplotlib 內部決定。輸出是可攜的,但你仍然需要一個可運作的 Python 環境、安裝好的 matplotlib 套件,以及足夠的上下文切換,才能讓腳本、資料與圖檔保持同步。
基於瀏覽器的 Bar Chart Maker 從相反的方向抵達同一個目的地。貼上資料、點擊一次,預覽就會顯示 matplotlib 本來會畫出的內容:五條垂直長條、零基準線、五個參考刻度、可選的標題,以及每條長條下方一個旋轉過的類別標籤。圖表高度固定為 520 像素;寬度則隨著類別增加而變大,當 30 個標籤會被擠進狹窄螢幕時,預覽會水平捲動。
瀏覽器工具強制執行的輸入規則
因為這個工具刻意做得很窄,每一筆輸入都必須遵循嚴格格式。可接受的格式是「label,value」——一個標籤、一個逗號、一個數值標記——至少兩列、最多三十列,且每一列都不能是空白。空白或僅含空白的行會被忽略。標籤最多 24 個 UTF-16 字碼單元,數值標記最多 40 個。任何一邊只要超過限制 1 個字碼單元,整個請求就會失敗。解析器絕不會默默只保留前 30 列、跳過錯誤列、把缺失值代換成零,或回傳部分圖表。
在數值方面,只接受非負的有限十進位數字。像是 12.75 這類一般小數,以及 1.2e3 這類科學記號都允許。負零會被正規化成零。詞法上溢位為零的輸入、超過 1e300 的輸入、十六進位、Infinity、NaN、運算式、加上單位的數字、加上引號的欄位、額外的欄位,以及空標籤,全部會被拒絕。重複的標籤在輸入順序中仍然是各自獨立的長條;這個工具不做彙總、排序或單位推斷。每個標籤與數字前後的空白會自動被修剪掉。
| 範例輸入 | 結果 |
|---|---|
| Apples, 73 | Accepted |
| Bananas,12 | Accepted (whitespace trimmed) |
| Oranges, 1.2e2 | Accepted (scientific notation) |
| Grapes, -5 | Rejected (negative value) |
| Plums, NaN | Rejected (not a finite number) |
| "Fuji, Red", 8 | Rejected (quoted field) |
| Pears, 45, 60 | Rejected (two commas) |
| ,73 | Rejected (empty label) |
| blank line | Ignored |
不寫 Python 也畫出同一張圖
- 輸入可選的標題,並把 2 到 30 筆嚴格的「標籤,數值」列貼進輸入區。每個非空列只能有一個逗號,左邊是標籤,右邊是一個非負的有限數字。
- 點擊 Generate 並檢查預覽。確認類別標籤讀起來正確、五個參考刻度完整呈現整個範圍、基準線落在零的位置,以及沒有任何長條因為極端的數值範圍而細到看不見。
- 點擊 Download SVG 來存檔。下載的字串與預覽中顯示的標記完全相同,檔案是一個帶有 W3C 命名空間的獨立 SVG,而解析、版面配置、預覽與下載全都留在當前瀏覽器分頁中執行。
編輯標題或資料會立刻清掉先前的預覽、狀態訊息與下載連結,因此舊的圖表絕不會洩漏到新的輸出中。下載的 SVG 可以直接用瀏覽器開啟、放進簡報,或貼進 HTML——它不依賴任何外部樣式表或腳本。
線性刻度與參考刻度是如何決定的
Bar Chart Maker 採用的是決定性的、由產品定義的「整齊範圍」做法,而不是重現 matplotlib 的內部刻度演算法。長條高度等於數值乘上繪圖高度再除以顯示的座標軸最大值,因此資料集裡最大的數值決定最上方的刻度位置。顯示的最大值會無條件進位到下一個嚴格大於最大值的 1、2、5 或 10 倍十的冪次有限倍數。接著由五個等距的參考刻度呈現這個範圍。
舉個具體例子,假設資料集的最大值是 73。73 落在 [10, 100) 這個區間,所以參考的十的冪次是 10² = 100。100 的 1/2/5/10 倍數分別是 100、200、500 與 1000。第一個嚴格大於 73 的倍數是 100,因此顯示的座標軸最大值變成 100。五個參考刻度依序是 0、25、50、75 與 100。一個數值為 25 的長條因此恰好達到繪圖高度的四分之一。座標會四捨五入到小數點後三位再寫進標記,而軸標籤在範圍需要時最多使用六個有效數字,或改用科學記號。
當資料集裡每個數值都是零時,圖表會切換到明確的零到一參考範圍,讓所有長條維持在基準線上的零高度,並加上「全部為零」的註記。這樣既能避免除以零的錯誤,又不會改動使用者提供的數值。
matplotlib 處理方式不同的邊界情況
有三種行為值得注意,因為它們和典型的 matplotlib 預設執行結果並不相同。
- 極端的數值範圍。當某個類別的數值比其他類別大上數百個數量級時,較小長條的像素高度可能低於 SVG 的座標精度而看起來消失。工具提示仍會回報實際數值,但若需要讓小型類別在視覺上仍可區隔,應該改用對數刻度或額外分組的圖表。
- 負值或非有限值。解析器會直接拒絕整個資料集,而非跳過錯誤列,因此單一筆的打錯字就會停止產生。這比 matplotlib 更嚴格,後者會默默為負值畫一條向下的長條。
- 沒有對數刻度,也沒有百分比正規化。這個工具不會切換到對數刻度、不會把長條正規化成佔總體的百分比,也不會暗示統計顯著性。如果觀眾需要比較佔全體的比例,圓餅圖會是更合適的選擇。
matplotlib vs. Bar Chart Maker 一覽
| 面向 | matplotlib | Bar Chart Maker |
|---|---|---|
| Runtime | Python interpreter with matplotlib installed | Current browser tab, no installation |
| Input shape | Lists, arrays, or pandas DataFrames | 2 to 30 strict label,value rows |
| Scale type | Linear or logarithmic | Linear only |
| Tick computation | matplotlib internal algorithm | 1/2/5/10 nice upper bound, five fixed ticks |
| Output formats | PNG, PDF, SVG, and others | Standalone SVG only |
| Data upload | Stays local unless explicitly saved online | Never leaves the browser tab |
| Code required | Yes | No |
對 matplotlib 使用者來說,實際的決策點在於:資料集是否小到(2 到 30 個類別)且夠「乖」(非負有限值、標籤中不含逗號),足以套進這個瀏覽器工具的嚴格格式。如果可以,瀏覽器路線就能把 import 陳述式、figure 呼叫、savefig 那一行與一次終端機執行,換成三次點擊。
下載前驗證 SVG
驅動預覽的那段單一字串就是最後變成下載 Blob 的那段字串,所以你看過的圖表就是實際收到的圖表。檔案採用 W3C SVG 命名空間,並使用標準的 rect、line、text、g 與 title 元素,因此能在現代瀏覽器、設計工具,以及接受 SVG 的文件編輯器中正確呈現。使用者輸入的字串會在進入文字、工具提示、標題或無障礙屬性前先做 XML 跳脫——&、角括號、引號與撇號都會變成實體,而 XML 不允許的控制字元會變成 U+FFFD。因此,長得像腳本的標籤會保持為可見文字,而不會變成 SVG 元素。
座標一律由通過驗證的有限數值產生,並四捨五入到小數點後三位,因此標記裡不可能出現超出範圍或非有限的座標。即使可見標題是空白的,仍會帶有「Bar chart」這個無障礙標籤,讓輸出對螢幕閱讀器保持友善。當標題或資料被編輯、結果被取代、產生過程發生錯誤,或元件卸載時,Blob URL 就會被撤銷,因此無論是立即撤銷導致的下載競爭,或是持續累積的 ObjectURL 洩漏都不會發生。如需底層標記的權威參考,請參閱 W3C SVG 2 規格;如需這個工具所模擬的線性刻度類型,請參閱 D3 線性刻度說明文件。
如果你正在比較各種選項,How to Make a Pie Chart in PowerPoint in 3 Steps 對此有詳細說明。
如果你正在比較各種選項,Generate Random Letters in Python Without Writing Code 對此有詳細說明。