如何用 mo.stop 和 run_button 防止 marimo 中昂贵的单元自动运行【免费下载链接】marimoA reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.项目地址: https://gitcode.com/GitHub_Trending/ma/marimomarimo 的单元在启动时、以及上游依赖变化时会自动重新运行。当单元里包含调用外部 API、长时间训练或大批量计算这类昂贵操作时自动运行很容易在无意中被触发。本文用 marimo 自带的mo.stop和mo.ui.run_button这两个 API把昂贵单元的执行权交给一个显式的按钮不点按钮单元就停在中途昂贵代码不会执行。适用前提是你在 marimo 编辑器marimo edit notebook.py或已部署的 marimo 应用中工作。mo.stop 的行为边界先看 mo.stop 的源码实现它决定了这套写法的准确语义调用mo.stop(predicate, output)时如果predicate为Truemarimo 抛出MarimoStopError该异常未被捕获时当前单元停止执行第二个参数output会成为该单元的输出比如一段 markdown 提示原本计划运行的下游单元descendants不会运行它们的定义会从程序内存中移除MarimoStopError继承自BaseException而不是Exception目的是避免被单元里的except Exception意外捕获这一点和KeyboardInterrupt的设计一致。因此mo.stop不是跳过某几行代码而是在条件满足时终止整个单元并连带阻止依赖它的单元这正适合用来给昂贵单元加闸门。最短可行路径run_button mo.stop官方示例 stop_execution.py 给出了完整的可直接运行的 notebook共三个单元import marimo __generated_with 0.19.7 app marimo.App() app.cell def _(): import marimo as mo return (mo,) app.cell def _(mo): button mo.ui.run_button() button return (button,) app.cell def _(button, mo): mo.stop(not button.value, Click the button to continue) mo.md(# :tada:) return if __name__ __main__: app.run()把最后这个单元里mo.stop之后的代码换成你自己的昂贵调用即可结构是app.cell def _(button, mo): # 按钮未被按下时button.value 为 False单元在此停止 mo.stop(not button.value, Click the button to continue) expensive_function_call() # 只有点击按钮后才会执行到这里其中not button.value是判断按钮尚未被按下的条件单元首次运行或依赖变化重新运行时button.value为Falsemo.stop生效expensive_function_call()不会执行用户点击按钮后button.value变为True条件不成立单元继续往下跑。官方指南中还展示了把提示做成 markdown 的写法mo.stop(not run_button.value, mo.md(Click to run this cell))如何验证闸门生效打开这个 notebook 后可以按文档展示的现象核对未点击按钮时昂贵单元的输出就是mo.stop的第二个参数——示例中是Click the button to continue或# :tada:之前的提示文字此时按钮下方的昂贵代码没有执行。点击按钮后button.value变化触发依赖它的单元重新运行mo.stop不再停止执行单元输出变为mo.md(# :tada:)示例结果。如果你的昂贵单元后面还有依赖它的下游单元未点按钮时它们同样不会运行——这是mo.stop抛出MarimoStopError后的既定行为。对应的官方文档入口是 Stopping execution 与 Run on button click。可选变体多个按钮或带标签的按钮如果昂贵任务有几种可选执行方式run_button 示例展示了给按钮加label并用多个按钮分支的写法app.cell def _(mo): first_button mo.ui.run_button(labelOption 1) second_button mo.ui.run_button(labelOption 2) first_button, second_button return first_button, second_button app.cell def _(first_button, second_button): if first_button.value: print(You chose option 1!) elif second_button.value: print(You chose option 2!) else: print(Click a button!) return这里label参数来自文档示例用于改变按钮上的文字分支逻辑用first_button.value/second_button.value判断哪个按钮被按下。这套写法不依赖mo.stop适合必须选择一种昂贵操作才继续的场景。与运行配置类手段的关系expensive_notebooks 指南还列了三种不写代码的控制方式它们和mo.stoprun_button解决的是同一个目标但粒度不同可以作为补充或替代禁用 cell 变化时的自动运行lazy execution在 notebook settings 的 runtime configuration 中配置。开启后运行某个单元时 marimo 只把依赖单元标记为 stale而不是自动运行它们。适合长期处理昂贵 notebook 的用户。禁用启动时的自动运行marimo 默认在启动时运行 notebookmarimo edit notebook.py的行为类似python notebook.py同样可以在 notebook settings 的 On startup 配置项中关闭。临时禁用单个单元marimo 支持把某个单元临时设为不自动运行适合只改一处、不想触发其他部分执行的情况详见 reactivity 指南。三者的区别在于配置类手段改变的是整个 notebook 的运行策略mo.stoprun_button则是针对某一个单元的显式闸门并且能把为什么没运行以单元输出的形式直接展示给协作者。限制mo.stop停止的是当前单元及其已调度的下游单元不能只跳过单元内部的某几行——它抛出的是终止型异常不是普通 return。MarimoStopError继承自BaseException如果你在昂贵单元里写了except Exception它拦不住这个异常但反过来也不要把mo.stop当作一般流程控制来 try/except 掉。本文只覆盖防止自动运行这一目标。昂贵计算的缓存mo.cache、mo.persistent_cache和懒加载 UImo.lazy是 expensive_notebooks 指南中的另外两个独立主题需要时再另行查阅。【免费下载链接】marimoA reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.项目地址: https://gitcode.com/GitHub_Trending/ma/marimo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
