组合容器¶

单个图形之外的下一个问题是组织：把多个 mobject 当成一个整体移动、缩放、着色。Manim 提供三个容器：Group、VGroup 与按键取值的 VDict。

Group¶

Group(*mobjects, **kwargs) 官方文档 ↗

Group 是最朴素的组合容器：把任意多个 Mobject 收进一个 submobjects 列表，整体参与布局与变换。它不校验成员类型，因此可以混合装入位图、3D 对象等任何 mobject。

Group(*mobjects, **kwargs)

name	type	default	desc
`*mobjects`	Mobject	—	任意数量的成员，可空
`kwargs`	—	—	转发给 `Mobject` 构造

常见错误

同一个 mobject 重复 add 进同一个组会被静默忽略（官方文档明确说明）。如果需要两个一样的图形，先 copy() 再添加。

VGroup¶

VGroup(*vmobjects, **kwargs) 官方文档 ↗

VGroup 是矢量图形的专用组合容器：成员必须是 VMobject，因此它继承了 VMobject 的全部样式方法，可以对整组统一 set_fill、整体渐变，并支持 arrange 自动排版。

VGroup(*vmobjects, **kwargs)

name	type	default	desc
`*vmobjects`	VMobject \| Iterable[VMobject]	—	成员；也可先建空组再 `add`
`kwargs`	—	—	转发给 `VMobject` 构造

与 Group 的对比如下：

维度	Group	VGroup
继承	Mobject	VMobject
成员类型	任意 Mobject	仅 VMobject，否则 `TypeError`
样式方法	无填充/描边概念	`set_fill` / `set_stroke` / `set_opacity` 等对整组生效
整体渐变	不支持	`set_color_by_gradient` 按子对象依次着色
典型场景	混合类型（位图 + 矢量 + 3D）	同类的矢量图形批量排版

arrange(RIGHT, buff=0.4) 一键横排；对整组 scale + rotate 时三个图形保持相对位置不变；下排演示用下标 squares[1] 取单个成员单独上色。

查看源码 groups_demo.py

from manim import *


class GroupsDemo(Scene):
    def construct(self):
        shapes = VGroup(Square(), Circle(), Triangle()).arrange(RIGHT, buff=0.4)
        self.play(FadeIn(shapes))
        self.play(shapes.animate.scale(0.7).rotate(PI / 8))
        squares = VGroup(*[Square(side_length=0.5) for _ in range(4)]).arrange(RIGHT)
        squares.to_edge(DOWN)
        self.play(FadeIn(squares))
        self.play(squares[1].animate.set_fill(YELLOW, 0.8))
        self.wait(0.5)

常见错误

VGroup(Square(), ImageMobject("a.png")) 会抛 TypeError——VGroup.add 会校验成员是 VMobject。混入非矢量对象时请改用 Group。

提示

arrange(direction=RIGHT, buff=0.25, center=True) 是 Mobject 上的方法，任何容器都能用：它按方向排开所有子对象并保持组中心不变。VGroup(*[Square() for _ in range(4)]) 批量构造列表成员是最常见的写法。

VDict¶

VDict(mapping_or_iterable={}, show_keys=False, **kwargs) 官方文档 ↗

VDict 是“字典版 VGroup”：每个成员关联一个可哈希的键，可以像 Python 字典一样 d["key"] 取值、d["key"] = mob 赋值。

VDict(
    mapping_or_iterable: Mapping[Hashable, VMobject] | Iterable[tuple[Hashable, VMobject]] = {},
    show_keys: bool = False,
    **kwargs,
)

name	type	default	desc
`mapping_or_iterable`	Mapping \| Iterable[tuple]	{}	初始键值对，如 `{"sq": Square()}`
`show_keys`	bool	False	是否在成员左侧显示键文本（调试用）

字典式操作一览：

操作	效果
`d["sq"]`	取出键对应的 mobject（`__getitem__`）
`d["tri"] = Triangle()`	新增或替换键值对（`__setitem__`）
`d.add({"c": Circle()})`	批量添加，参数同构造的映射
`d.remove("sq")`	按键移除
`d.keys()` / `d.values()` / `d.items()`	字典三件套

VDict 按键索引：d["sq"] 单独给方块填色，d["tri"] = ... 动态新增一个三角形成员。

查看源码 vdict_demo.py

from manim import *


class VDictDemo(Scene):
    def construct(self):
        d = VDict({"sq": Square(), "ci": Circle()})
        d.arrange(RIGHT, buff=0.5)
        self.play(FadeIn(d))
        self.play(d["sq"].animate.set_fill(BLUE, 0.7))
        d["tri"] = Triangle().next_to(d["ci"], RIGHT)
        self.play(FadeIn(d["tri"]))
        self.wait(0.5)

常见错误

show_keys=True 会用 Tex 渲染键名，需要本机安装 LaTeX；没有 LaTeX 环境时请保持默认 False。另外 VDict 的值必须是 VMobject，与 VGroup 一样会做类型校验。

自测¶

下一步¶

容器就位后，下一节进入实战：圆、矩形、多边形等基本形状的参数与画法。