这次发布的是一个“补丁版本”，距离上次的大版本发布只有几天。
主要修改部分是：
✅ Bug 修复（MathTex 解析、DashedLine 动画、AnimationGroups 检测等）
✅ 小优化（Docker 镜像、警告静音）
✅ 文档补充
如果你正在使用 Manim 制作数学动画，建议尽快升级以获得更稳定的体验。
以下是本次更新的核心内容整理及代码示例。
🚀 核心亮点与代码示例
1. MathTex 双大括号解析修复
在之前的版本中，MathTex 在处理 LaTeX 原生的双大括号 }} 时可能会错误地触发分割逻辑，导致公式渲染失败或显示异常。v0.20.1 修复了这一问题，现在你可以更放心地在公式中使用集合或嵌套括号。
示例：正确使用双大括号
from manim import *
class MathTexFixExample(Scene):
def construct(self):
# 之前版本可能会在这里解析出错
# 现在可以正常渲染包含 }} 的 LaTeX 公式
equation = MathTex(r"\{ x \in \mathbb{R} \mid x^2 \geq 0 \}")
self.play(Write(equation))
self.wait()
2. 零长度 DashedLine 支持
曾经，如果你尝试创建或动画化一个起点和终点重合（零长度）的 DashedLine，Manim 可能会抛出错误。新版本修复了 this 边缘情况，使得动态调整线段长度变得更加鲁棒。
示例：动态变化的虚线
from manim import *
class DashedLineZeroLength(Scene):
def construct(self):
start_point = ORIGIN
end_point = RIGHT
# 创建一个虚线
line = DashedLine(start_point, end_point)
self.add(line)
# 动画将终点移动回起点，形成零长度线段
# v0.20.1 修复了此类动画可能崩溃的问题
self.play(line.animate.put_start_and_end_on(start_point, start_point))
self.wait()
3. 嵌套 AnimationGroups 与 Z-Index 修复
对于复杂动画，特别是嵌套的 AnimationGroup 中包含带有 z_index 属性的 mobjects 时，移动对象检测曾存在问题。这可能导致图层顺序混乱或动画追踪失败。本次更新修复了嵌套组中的对象检测逻辑。
示例：嵌套动画组
from manim import *
class NestedAnimationGroupFix(Scene):
def construct(self):
circle = Circle().set_fill(RED, opacity=0.5)
square = Square().set_fill(BLUE, opacity=0.5)
# 设置不同的 z_index
circle.z_index = 2
square.z_index = 1
# 嵌套 AnimationGroup
group_anim = AnimationGroup(
AnimationGroup(circle.animate.shift(RIGHT)),
AnimationGroup(square.animate.shift(LEFT)),
lag_ratio=0.5
)
self.add(square, circle)
self.play(group_anim)
self.wait()
4. LaggedStartMap 参数传播控制
修复了 LaggedStartMap 中 kwargs 意外传播给所有子对象的问题。现在你可以更精确地控制传递给每个映射对象的参数，避免不必要的属性污染。
🛠 开发者体验优化
除了用户可见的功能修复，v0.20.1 还在底层做了不少改进，让开发和使用过程更顺畅：
- Docker 镜像优化：优化了 Docker 镜像的构建流程和运行时占用空间，对于使用容器化部署的用户来说，拉取和运行速度将更快。
- FFmpeg 警告静音：当系统中缺少 ffmpeg CLI 时，不再弹出烦人的
pydub导入警告，控制台输出更干净。 - 类型提示增强：为
manim/_config/utils.py添加了类型注解，有助于 IDE 提供更好的代码补全和错误检查。 - TipableVMobject 清理：修复了可变默认参数问题及
assign_tip_attr的拼写错误，提升了代码内部稳定性。
📚 文档更新
- 本地安装指南：新增了将 Manim 作为本地包手动安装的文档说明，方便需要定制开发的用户。
- 可访问性提升：为 README.md 中的所有图片添加了替代文本（alt text），使文档对屏幕阅读器更友好。
📥 如何升级
你可以通过 pip 轻松升级到最新版本：
pip install --upgrade manim
