建立 2026-10-13 更新 2026-10-13

安裝與執行環境

使用 Plotly Express 只需要安裝 plotly 與 pandas 兩個套件；圖表會依執行環境（Jupyter、VS Code、Colab、一般 Python 腳本）自動選擇顯示方式。本頁說明安裝指令、各環境的顯示方式，以及圖表不出現時的排除步驟。

安裝套件

pipuvconda

pip install plotly pandas

uv add plotly pandas

conda install -c conda-forge plotly pandas

依需求再加裝的選用套件：

套件	用途
`nbformat`	在 Jupyter／VS Code Notebook 中顯示圖表（新版 Jupyter 通常已內建）
`statsmodels`	散佈圖的 `trendline="ols"`／`"lowess"` 趨勢線
`kaleido`	用 `write_image` 輸出 PNG／SVG／PDF 靜態圖（Plotly 7 需要 Kaleido v1 以上，且電腦需有 Chrome）
`anywidget`	使用 `go.FigureWidget` 在 Notebook 中做雙向互動

確認版本：

import plotly
print(plotly.__version__)  # 本站以 7.1 為準

在不同環境顯示圖表

Plotly Express 的函式會回傳一個 Figure 物件。顯示它有兩種方式：

Notebook 最後一行直接放 Figure：Jupyter、JupyterLab、VS Code、Google Colab 會自動顯示。
呼叫 fig.show()：在任何環境都可以用；在一般 .py 腳本中執行時，會開啟預設瀏覽器顯示圖表。

import plotly.express as px

fig = px.bar(x=["A", "B", "C"], y=[3, 1, 2])
fig.show()

什麼是 renderer？

Renderer 是 Plotly 決定「圖要畫到哪裡」的機制，例如 notebook、vscode、colab、browser、png。Plotly 會自動偵測，通常不必設定；遇到圖不顯示或要強制改成靜態圖時，才需要手動指定：

import plotly.io as pio

print(pio.renderers)              # 列出可用 renderer 與目前預設值
pio.renderers.default = "browser"  # 改成用瀏覽器開啟

fig.show(renderer="png")          # 只有這一次輸出靜態 PNG（需 kaleido）

圖表不顯示怎麼辦？

依序檢查：

套件版本：plotly 太舊或 Jupyter 擴充不相容。先升級 pip install -U plotly。
缺少 nbformat：錯誤訊息出現 Mime type rendering requires nbformat 時，安裝 pip install nbformat 並重啟 kernel。
renderer 不對：在 IDE 的互動視窗中看不到圖，可改 pio.renderers.default = "browser"。
Notebook 存檔後重開沒有圖：Notebook 預設不信任（untrusted），在 Jupyter 中選「Trust Notebook」即可。

官方的完整排除步驟見 Troubleshooting in Python。

線上免安裝練習

Google Colab 已預裝 plotly 與 pandas，開一個新 Notebook 就能直接 import plotly.express as px 開始練習。

安裝與執行環境

安裝套件

在不同環境顯示圖表

什麼是 renderer？

圖表不顯示怎麼辦？

推薦影音

Getting Started With Plotly（Charming Data）

相關頁面