manimce-best-practices

使用指南

查阅各规则文件以获取详细说明与代码示例：

核心概念

• rules/scenes.md - Scene 场景结构、construct 构建方法及场景类型
• rules/mobjects.md - Mobject 动画对象类型、VMobject、Group 分组及定位
• rules/animations.md - 动画类、播放动画与时序控制

创建与变换动画

• rules/creation-animations.md - Create、Write、FadeIn、DrawBorderThenFill 等生成动画
• rules/transform-animations.md - Transform、ReplacementTransform 与形变动画
• rules/animation-groups.md - AnimationGroup、LaggedStart、Succession 等动画组控制

文本与数学公式

• rules/text.md - Text 文本对象、字体与样式排版
• rules/latex.md - MathTex、Tex、LaTeX 排版及公式着色
• rules/text-animations.md - Write、AddTextLetterByLetter、TypeWithCursor 等文本逐字动画

样式与视觉外观

• rules/colors.md - 颜色常量、渐变色及色彩调配
• rules/styling.md - 填充（Fill）、描边（Stroke）、透明度及视觉属性

定位与布局

• rules/positioning.md - move_to、next_to、align_to、shift 等位置调整方法
• rules/grouping.md - VGroup、Group、arrange 及布局模式

坐标系与函数绘图

• rules/axes.md - Axes 坐标轴、NumberPlane 坐标网格与坐标系
• rules/graphing.md - 函数图像绘制、参数曲线
• rules/3d.md - ThreeDScene、3D 坐标轴、曲面及视角控制

动画控制与动态更新

• rules/timing.md - 速率函数（Rate functions）、缓动效果、run_time 与 lag_ratio
• rules/updaters.md - Updaters 实时更新器、ValueTracker 与物理/动态联动动画
• rules/camera.md - MovingCameraScene、镜头缩放、平移与画幅控制

配置与命令行（CLI）

• rules/cli.md - CLI 命令行接口、渲染选项及画质参数
• rules/config.md - 配置系统、manim.cfg 及参数设置

形状与几何图元

• rules/shapes.md - Circle（圆）、Square（正方形）、Rectangle（长方形）、Polygon（多边形）等几何图形
• rules/lines.md - Line（线段）、Arrow（箭头）、Vector（向量）、DashedLine（虚线）及连接线

实战示例

完整且经过测试的示例代码，展示常见开发模式：

• examples/basic_animations.py - 基础图形创建、文本、交错动画及沿路径移动
• examples/math_visualization.py - LaTeX 数学公式、分色渲染公式及公式推导动画
• examples/updater_patterns.py - ValueTracker 动态更新、实时动画与物理仿真
• examples/graph_plotting.py - 坐标轴、函数图像、曲线包围面积、黎曼和及极坐标图
• examples/3d_visualization.py - ThreeDScene、3D 曲面、三维视角变换及参数曲线

场景模板

可直接复制并修改这些模板来快速启动新项目：

• templates/basic_scene.py - 标准 2D 场景模板
• templates/camera_scene.py - 支持缩放/平移的 MovingCameraScene 场景模板
• templates/threed_scene.py - 支持曲面渲染与镜头旋转的 3D 场景模板

快速参考

基础场景结构

from manim import *

class MyScene(Scene):
    def construct(self):
        # 创建动画对象 (mobjects)
        circle = Circle()

        # 直接添加到场景中（静态显示）
        self.add(circle)

        # 或者播放生成动画
        self.play(Create(circle))

        # 停顿等待
        self.wait(1)

渲染指令

# 渲染基础画面并实时预览
manim -pql scene.py MyScene

# 画质参数选项：-ql (低画质), -qm (中画质), -qh (高画质), -qk (4K 超清)
manim -pqh scene.py MyScene

与 3b1b / ManimGL 的核心区别

特性	Manim Community (社区版)	3b1b / ManimGL
导包模块	from manim import *	from manimlib import *
CLI 命令	manim	manimgl
数学公式	MathTex(r"\pi")	Tex(R"\pi")
场景基类	Scene	InteractiveScene
PyPI 包名	manim	manimgl

Jupyter Notebook 支持

使用 %%manim Cell 魔法命令：

%%manim -qm MyScene
class MyScene(Scene):
    def construct(self):
        self.play(Create(Circle()))

常见避坑指南

1. 版本混淆 - 确保使用的是 manim（社区维护版），而不是 manimgl（3b1b 个人版本）
2. 检查导包语句 - from manim import * 代表 ManimCE；from manimlib import * 代表 ManimGL
3. 注意教程时效性 - 网上部分视频教程可能基于旧版本制作，建议优先参考官方最新文档
4. manimpango 依赖报错 - 如果渲染文本时报错，请检查系统的 manimpango 依赖环境是否安装完整
5. Windows 环境变量（PATH）问题 - 如果提示找不到 manim 命令，请使用 python -m manim 运行或检查环境变量配置

安装说明

# 安装 Manim Community 社区版
pip install manim

# 检查环境与安装状态
manim checkhealth

常用命令汇总

manim -pql scene.py Scene    # 低画质快速预览（开发调试推荐）
manim -pqh scene.py Scene    # 高画质预览
manim --format gif scene.py  # 导出为 GIF 动图
manim checkhealth            # 检查环境健康状况
manim plugins -l             # 查看已安装插件列表