# 交给客户的 notebook，不该依赖单元格执行顺序

> marimo 把 notebook 存成纯 Python 文件，自动重跑依赖单元格，过期图表不再混进交付物。

原文: https://fdetimes.net/zh/tools/marimo-reactive-notebooks-client-work/

交给客户的 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 也能作为脚本运行，并接受命令行参数。于是同一个文件，既是探索草稿，也是定时任务，还是展示应用。

## 哪些限制应该先和客户说清？

第一是包版本。沙箱文档写明，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。他们记得的是，上个月的数字和这个月对不对得上。

**本周动手试试:**

- 找一个发给过客户的 Jupyter notebook，用命令行工具转换为 marimo 格式，再用 `uvx marimo edit --sandbox` 打开，看看哪些单元格依赖了隐藏状态。
- 对这个 notebook 运行 `marimo run`，拿给一位不看代码的同事看，检验隐藏代码后结果能否自己说明问题。
- 把 notebook 提交到 Git，修改一个参数，然后读一遍 diff，看看审阅者会看到什么。

## 信源

- [marimo | a next-generation Python notebook](https://marimo.io)

- [marimo: The Reactive Python Notebook](https://docs.marimo.io/)

- [GitHub - marimo-team/marimo: A reactive notebook for Python](https://github.com/marimo-team/marimo)

- [Coming from Jupyter](https://docs.marimo.io/guides/coming_from/jupyter/)

- [Run as an app](https://docs.marimo.io/guides/apps/)

- [Working in sandboxes](https://docs.marimo.io/guides/package_management/sandboxes/)

- [CoreWeave Acquires Marimo to Unify the Generative AI Developer Workflow](https://coreweave.com/news/coreweave-acquires-marimo-to-unify-the-generative-ai-developer-workflow)
