安装入门：从零搭建 Manim 环境

本文以 Manim Community Edition（社区版）为例，覆盖三大平台的安装步骤与常见问题。全程约 15 分钟。

1. 准备基础环境

• Python ≥ 3.9：建议使用 3.11 / 3.12 稳定版本；可用 python --version 确认。
• FFmpeg：Manim 依赖 FFmpeg 合成视频。
  • Windows：推荐 winget install Gyan.FFmpeg，或使用包管理器 Chocolatey / Scoop；
  • macOS：brew install ffmpeg；
  • Linux（Debian/Ubuntu）：sudo apt install ffmpeg。
• LaTeX（可选）：只有使用 MathTex 渲染公式时才需要。
  • Windows：安装 MiKTeX；
  • macOS / Linux：安装 MacTeX / TeX Live（Full 版省心，精简版需按需补包）。

2. 安装 Manim

强烈建议在虚拟环境中安装，避免污染全局环境：

# 创建并激活虚拟环境
python -m venv manim-env

# Windows
manim-env\Scripts\activate
# macOS / Linux
source manim-env/bin/activate

# 安装 Manim 社区版
pip install manim

安装完成后验证：

manim --version

3. 渲染第一个场景

新建 hello.py：

from manim import *

class HelloManim(Scene):
    def construct(self):
        text = Text("Hello, Manim!", font_size=48)
        self.play(Write(text))
        self.wait()

低画质快速预览（推荐日常开发）：

manim -pql hello.py HelloManim

常用画质选项：

• -ql：480p 低画质，预览最快；
• -qm：720p 中等画质；
• -qh：1080p 高画质，成片导出用；
• -p：渲染完成后自动播放；
• -i：同时导出 GIF。

4. 常见问题排查

4.1 manim 命令找不到

确认虚拟环境已激活；Windows 下若仍找不到，尝试 python -m manim ... 代替直接调用。

4.2 MathTex 报 LaTeX 错误

未安装 LaTeX 或缺少宏包。最省事的做法是安装完整版 TeX Live / MiKTeX；排错时先跑一个最简公式验证：

class TryTex(Scene):
    def construct(self):
        self.play(Write(MathTex(r"E = mc^2")))
        self.wait()

4.3 中文文字乱码或不显示

Text 默认字体可能不含中文。指定系统中存在的字体即可：

Text("你好，Manim", font="Microsoft YaHei")   # Windows
Text("你好，Manim", font="PingFang SC")      # macOS
Text("你好，Manim", font="Noto Sans CJK SC") # Linux

4.4 Windows 下 dvisvgm 相关报错

多为 MiKTeX 组件缺失，在 MiKTeX Console 中更新宏包并确认 dvisvgm 可执行文件在 PATH 中。

5. 推荐的项目结构

my-manim-project/
├── media/          # 渲染输出目录（自动生成）
├── scenes/         # 各章节场景代码
│   ├── ch01.py
│   └── ch02.py
└── assets/         # 图片、音频等素材

下一步：阅读基础教程，系统掌握图形、动画、文字与坐标系的用法。