只想在某一小段代码里改配置、出了这段就恢复,用 tempconfig 上下文管理器最干净。上面的完整示例把「进入前 / 块内 / 退出后」三个时刻的 frame_rate、frame_width 读数并排显示,同时验证两个容易踩的坑:未知键会被静默过滤、块内抛异常也能还原。所有数值都在运行时从 config 读取,不写死,换成任何渲染配置都能直接跑。
完整代码
1 | from manim import * |
演示视频
要点
with tempconfig({...}):只在with块内生效,退出时自动还原,不用手写恢复代码- 传入字典或
ManimConfig都可以,键名与config的属性名一致,如frame_rate、background_color - 未知键会被静默忽略:源码先做
{k: v for k, v in temp.items() if k in original},写错键名既不报错也不生效,排查时很容易漏 - 异常安全:内部是
try: yield+finally: config.update(original),块内抛异常照样回滚 - 别拿它改输出规格:分辨率、帧率、像素尺寸在 Scene 初始化时已锁定,运行中改只影响读到的值,不改变本次输出的视频
- 中文文字要显式指定中文字体,例如
Text("中文", font="STLiti"),否则会出现豆腐块
原理:为什么是 update 而不是赋值
tempconfig 的实现有一处刻意设计,值得单独看(伪代码):
1 | original = config.copy() |
config 是 Manim 各模块共同引用的全局对象。若写成 config = {...},只是让当前函数的局部变量指向一个新字典,
其他模块持有的仍是旧对象,改动根本不会生效;用 config.update(...) 才是原地修改同一个对象。
退出时用 original 再 update 回去,所有模块看到的状态一起回滚。这也解释了为什么脚本里 from manim import * 导入的 config 能在 with 块内外读到不同数值——它始终指向同一个对象,只是内容被临时改过。
代码来源:Manim Community 官方教程 Guides / Configuration 的
tempconfig用法;示例代码按 Manim CE 0.21.0 重写并实跑验证,演示视频由该脚本真实渲染生成(1920×1080 / 60fps)。

















