用途:marimo-notebook 用于构建可复现、响应式的 marimo 笔记本。笔记本本身是纯 .py 文件,可当作脚本、应用运行,或导出为 HTML。适合替代 Jupyter 实现确定性执行、把分析交付为脚本或 Web 应用,以及导出报告。
主要能力:基于依赖的响应式单元格执行;无隐藏状态,运行结果确定;通过 mo.cli_args() 接收命令行参数;使用 marimo export html 导出报告。
使用方式:安装命令为 uv pip install marimo;编辑笔记本用 marimo edit notebook.py;运行应用用 marimo run notebook.py;导出报告用 marimo export html notebook.py -o report.html -- --name Alice。CLI 参数示例:import marimo as mo;args = mo.cli_args();name = args.get("name", "World");mo.md(f"# Hello, {name}!")。
适用场景:需要确定性执行的分析、以脚本或 Web 应用形式交付分析、导出 HTML 报告。
限制与注意:避免使用全局变量,依赖单元格输出以避免隐藏状态;开销大的单元格可用 mo.stop() 控制;为便于复用应使用描述性文件名。更多文档见 https://docs.marimo.io/。