marimo 配置：4 层优先级讲透运行时与编辑器设置

marimo 配置4 层优先级讲透运行时与编辑器设置【免费下载链接】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改了一行动态导入的模块整本笔记本却要手动全部重跑——marimo 的自动重载机制就是为这类痛点设计的模块文件一变它把受影响的单元格标记为待重新运行或按你的策略自动补跑。而待运行还是自动跑、SQL 结果默认落到 polars 还是 pandas、保存后要不要自动格式化都由 marimo 配置决定。4 层配置优先级谁覆盖谁marimo 把配置分成四层高层覆盖低层缺失的字段逐层落回。优先级层级存放位置生效范围1脚本内配置笔记本头部/// script注释块PEP 723仅当前笔记本2项目级配置项目内pyproject.toml的[tool.marimo]或独立marimo.toml整个项目3全局配置主目录~/.marimo.toml或 XDG 路径下的同名文件你机器上的所有项目4内置默认值marimo/_config/config.py 中的DEFAULT_CONFIG兜底临时改比如给某一次实验单独调大输出上限写进脚本头关掉笔记本就没了影响。长期改比如全公司统一format_on_save写进项目配置进版本库只属于你个人的比如主题和字体写进全局配置。场景一数据探索流当你的工作流以 SQL 查询和表格浏览为主时先让结果格式跟你的库对齐。[tool.marimo.runtime] default_sql_output polars [tool.marimo.display] dataframes plain default_table_page_size 20default_sql_output控制 SQL 单元格结果的默认容器取值auto默认自动检测环境里可用的库、polars、lazy-polars、pandas、native数据库驱动原生结果。设成polars后查询结果直接进 polars 管道不用每格手动collect()。dataframes在rich和plain之间切换前者是带图表入口和列摘要的富展示默认值后者是纯表格导出和截图更干净。default_table_page_size调大表格默认每页行数少按几次翻页。场景二库与工具开发流当你一边改模块代码、一边用笔记本调试时默认配置恰好反着来auto_instantiate默认false没问题但on_cell_change默认autorun会把依赖链一路自动重跑。[tool.marimo.runtime] auto_instantiate true auto_reload lazy on_cell_change lazyauto_instantiate控制打开笔记本是否自动运行全部单元格只作用于编辑态部署成应用时不受影响。开发中的工具型笔记本建议设为true省掉每次手动Run All。auto_reload取off、lazy、autorunlazy在你保存模块文件后只把导入了该模块的单元格标红为待重跑autorun则直接替你重跑。什么该开、什么该关按项目性质分库/工具开发auto_instantiate trueauto_reload lazyon_cell_change lazy。改动可见、重跑可控写文件、发请求这类有副作用的单元格不会在你改代码的瞬间被触发。数据分析/教学演示维持默认autorun改一个上游单元格下游链路自动刷新观众不用等你按运行。场景三团队协作流当多人共用一个仓库时保存习惯和依赖安装工具最容易各写各的。[tool.marimo.save] autosave after_delay autosave_delay 2000 format_on_save true [tool.marimo.package_management] manager uv自动保存默认就是after_delay且autosave_delay 1000调大延迟可以减少频繁落盘format_on_save默认false团队里有人手动复制粘贴、格式漂移时打开它让保存动作顺带完成格式化。包管理器默认由 marimo/_config/packages.py 按系统已安装工具推断多人环境装得不一致时补依赖就会走不同工具显式指定manager可选pip、uv、rye、poetry、pixi消除分歧。把pyproject.toml或marimo.toml提交进版本库同事 clone 下来行为一致且项目层会覆盖个人的全局配置。个人偏好——主题、字体——留在自己的~/.marimo.toml不进库。进阶开关用环境变量临时覆盖运行时。只针对当前 shell 会话生效比改三层文件都干净export MARIMO_OUTPUT_MAX_BYTES16000000 # 单元格输出上限字节 export MARIMO_STD_STREAM_MAX_BYTES2000000 # 控制台输出上限marimo vim 键位与快捷键覆写。编辑器设置里换键位布局、补个别高频快捷键[tool.marimo.keymap] preset vim vimrc ~/.config/marimo/marimo.vimrc overrides { run-cell CtrlEnter }overrides把动作名映射到快捷键只对指定动作生效其余沿用预设。自定义代码片段目录。把团队常用模板挂进编辑器补全include_default_snippets true保留内置片段[tool.marimo.snippets] custom_paths [~/.marimo/snippets]FAQQ配置改了没生效先看脚本头/// script块里有同名项会覆盖项目配置。再看缓存项目级配置有读取缓存改完pyproject.toml需要重启服务器才生效脚本头配置同理。Q全局配置和项目配置冲突时谁赢项目层赢。合并顺序是全局层在前、项目层在其后后合并者覆盖组装逻辑见 marimo/_config/manager.py。同一次会话里脚本头又覆盖项目层环境变量覆盖最靠上。Q脚本头里写的配置为什么不生效脚本头是 PEP 723 元数据能设置的段有白名单runtime.auto_instantiate、experimental.isolate_apps、display.custom_css会被安全机制剥离ai、mcp、completion、secrets、server等顶层段整个不生效。所以上文的auto_instantiate false要写进项目配置而不是脚本头。Qdefault_sql_output auto到底选什么auto按当前环境检测可用库决定输出格式环境里没有装 polars/pandas 时可能回落到原生结果。想行为确定就显式指定。收尾marimo 各层配置是深度合并缺省字段自动落回DEFAULT_CONFIG所以配置文件里只写你要覆盖的项即可。配置项定义与默认值集中在 marimo/_config/config.py合并与层级组装逻辑在 marimo/_config/manager.py想确认某个键的取值范围直接查源码。【免费下载链接】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），仅供参考