交给客户的 notebook,不该依赖单元格执行顺序
marimo 把 notebook 存成纯 Python 文件,自动重跑依赖单元格,过期图表不再混进交付物。
要点速览
- marimo 把 notebook 保存为纯 Python 文件,并按依赖关系重跑单元格,不会像 Jupyter 那样留下隐藏状态。
- `marimo run` 把 notebook 变成 Web 应用,默认隐藏代码、只显示结果,适合非技术人员查看。
- 沙箱模式会在文件顶部记录 Python 版本和包列表,但要锁定精确版本,仍然需要 lockfile。
交给客户的 Jupyter notebook,出问题的地方往往没人看得见:单元格的执行顺序。marimo 是 Marimo 公司(成立于 2022 年)推出的开源 notebook,思路不同。每个 notebook 都是一个纯 Python 文件,运行某个单元格时,依赖它的单元格会自动重跑。
对前线部署工程师(FDE)来说,这个差别决定了交付质量。你交出去的分析,要能在下个月新数据到来时重跑,要能在团队其他人接手时重跑,也要能在客户追问某个数字从哪来时重跑。
官网对 marimo 的描述是:保留 notebook 的使用手感,同时具备 Python 程序的特性。能重跑、能交接、每个数字都能追溯来源,这些是对程序的要求,不是对草稿的要求。
Jupyter 的真正问题是隐藏状态
marimo 的 Jupyter 迁移指南直言,Jupyter notebook 很容易积累“隐藏状态”,隐藏的 bug 也随之而来。这份指南还指出了单元格乱序执行的风险。一旦发生,屏幕上的结果很容易和眼前的代码对不上。
假设你在为一家配送公司分析客户流失。第 3 个单元格按区域筛选,第 5 个单元格画图。你改了第 3 个单元格里的筛选阈值,忘了重跑第 5 个,就导出文件发了出去。文件里的图表,用的还是旧阈值。
marimo 在代码执行层面杜绝了这种情况。一个单元格运行时,marimo 会重跑所有引用该单元格变量的单元格。项目 README 列出了三项承诺:没有隐藏状态、确定性执行、内置包管理。
最小流程:从 notebook 到客户应用
还是那家配送公司。你用 uvx marimo edit --sandbox churn.py 在隔离环境中打开 notebook。uv 是沙箱的默认后端,从 PyPI 安装包。Python 版本和包列表按 PEP 723 标准写进文件顶部的注释块,notebook 自带运行环境。
你写三个单元格:加载数据、按阈值筛选、画图。修改阈值后,图表自动更新,不用记着该重跑哪些单元格。文件是纯 Python 而不是 JSON,提交到 Git 后,diff 读起来和普通代码一样,审阅者能准确看到改动的是哪一行阈值。
到了交付环节,运行 marimo run churn.py。它把 notebook 呈现为应用,并启动一个 Web 服务器提供访问。应用默认只排布输出、隐藏代码,客户的运营经理只会看到图表和表格。
如果报告需要每月跑一次,README 提到 marimo notebook 也能作为脚本运行,并接受命令行参数。于是同一个文件,既是探索草稿,也是定时任务,还是展示应用。
Jupyter
- 以 .ipynb JSON 格式存储
- 单元格执行顺序只存在于用户脑子里
- 容易积累隐藏状态
marimo
- 存为纯 .py 文件,可在 Git 中查看 diff
- 依赖的单元格自动重跑
- 可作为脚本或 Web 应用运行
哪些限制应该先和客户说清?
第一是包版本。沙箱文档写明,PEP 723 块存储的是包依赖要求,精确版本需要 lockfile。如果客户六个月后要重跑分析,并且需要得到相同的数字,一开始就生成 lockfile。
第二是基础设施。marimo run 会启动 Web 服务器,但服务器跑在哪里、谁能访问、客户数据放在哪台机器上,都是你的部署工作。在承诺“打开链接就能看”之前,先和客户的 IT 团队把这些谈妥。
第三是企业客户常问的供应商风险。CoreWeave 于 2025 年 10 月 30 日宣布收购 Marimo,并承诺 marimo notebook 将继续在宽松许可证下免费开源。项目采用 Apache-2.0 许可证,足以回答法务部门的问题。
最后,marimo 提供命令行工具,可以把 .ipynb notebook 转换成它的格式。不过,原本靠隐藏状态才能跑通的旧 notebook,转换后可能暴露出 bug。这是好事,但在把新版本发给客户之前,要留出时间审查。
先学什么,简历上怎么体现
先学会用依赖关系思考:每个单元格定义了哪些变量、用到了哪些变量。等这成为习惯,沙箱和 marimo run 不过是两条命令。顺带学一下 uv 也值得,它是沙箱的默认后端。
作品集方面,一个公开仓库,里面有 .py notebook、文件顶部的依赖块,以及 diff 干净的提交历史,比简历上写“精通 Python”更有说服力。
简历上要写你交付了什么,而不只是用了哪些工具。可以参考这个模板改写:“以 marimo notebook 交付客户流失分析,代码托管于 Git,运行环境记录在文件内并配有 lockfile;客户通过隐藏代码的应用查看结果,并以参数化脚本每月重跑。”
面试时,准备好讲一个经历:你如何把一份分析变成客户能自己重跑的东西,包括途中发现的隐藏状态 bug。这个故事能让面试官看到,你考虑的是接收方,而不只是自己的机器。
客户很少记得你用的是哪个 notebook。他们记得的是,上个月的数字和这个月对不对得上。
这篇文章对你有帮助吗?
感谢你的反馈!