marimo 深度解析：把響應式 Python 筆記本存成可測試腳本

marimo 是響應式 Python 筆記本，檔案保存為一般 `.py`，儲存格之間依變數定義和引用形成相依圖。本次抓取有 21,925 個 Star，近 30 天約 171 次提交，最新版本為 0.23.14。它處理的核心問題是隱藏狀態、錯誤執行順序，以及 JSON 筆記本難以審查的差異。

它可用於資料探索、SQL 查詢、模型實驗、教學內容、互動報表和內部工具。內建 UI 元件把滑桿、表格和表單值交給 Python；SQL 儲存格查詢後可回傳資料框；同一檔案可進入編輯器、當腳本執行，或以唯讀應用提供。AI 輔助是選用能力，並非執行筆記本的必要條件。

marimo 靜態分析每個儲存格定義與讀取的名稱，建立有向無環相依圖。變數改變時，系統依拓撲順序只執行受影響的下游儲存格；刪除儲存格也會清除其定義。多個儲存格不得重複定義同一變數。昂貴計算可延遲執行，但原地修改可變物件未必會被相依分析識別。

後端和筆記本程式以 Python 為主，瀏覽器介面使用 TypeScript 與 React。檔案是可匯入、可測試並可由 Git 清楚顯示差異的 Python 程式；應用模式透過 Web 前端傳遞互動值，觸發後端運算。WebAssembly 版本利用 Pyodide 在瀏覽器執行 Python，免伺服器但受限於套件、瀏覽器資源和持久儲存。

用 `pip install marimo` 安裝後，先執行 `marimo tutorial intro` 熟悉規則，或以 `marimo edit notebook.py` 建立檔案。`marimo run notebook.py` 啟動唯讀應用，`python notebook.py` 則按腳本執行。轉換既有筆記本後，必須逐項檢查小工具、擴充、魔法命令和環境相依，格式轉換不代表行為完全相同。

純 Python 儲存讓程式審查、格式化、匯入和測試更自然，相依驅動執行也減少亂序產生的舊結果。代價是作者要遵循單一變數定義和響應式思維；依賴外部副作用、全域狀態或原地修改的程式可能要重構。大型相依圖重算成本、Jupyter 擴充差異和既有教材，都會影響遷移價值。