在 Cursor 中从零安装 Manim 制作数学动画

在 Cursor 中从零安装 Manim 制作数学动画

你是否曾羡慕过 3Blue1Brown 那些流畅优雅的数学动画？其实，用 Manim 也能实现。今天咱们就在 Cursor 编辑器里把环境搭起来，一步步搞定。

一、Python 环境确认

Manim 是 Python 库，所以得先看看你的电脑有没有 Python。打开终端（Cursor 内置终端或系统命令行），输入：

python --version

如果看到类似 Python 3.9.x 的版本号，说明没问题。要是提示'不是内部命令'，那就得先去官网装一个，记得勾选 Add to PATH。

二、FFmpeg 视频处理工具

这一步很多人会忽略，但它是渲染视频的关键。没有它，Manim 只能生成图片序列。

• Windows：去官网下载预编译包，解压后把 bin 目录加到环境变量 PATH 里。
• macOS：推荐用 Homebrew 安装：brew install ffmpeg
• Linux：直接用包管理器，比如 sudo apt install ffmpeg

装好后，在终端敲 ffmpeg -version 验证一下，有输出版本信息就算成功了。

三、安装 Manim 核心库

环境齐了，直接通过 pip 安装。建议在虚拟环境中操作，避免污染全局环境：

pip install manim

安装过程可能需要几分钟，取决于网络状况。如果遇到依赖冲突，试试加上 -U 参数强制升级。

四、初始化配置与第一个场景

安装完别急着跑，先初始化配置文件，这样后续渲染参数就能统一管理：

manim config init

接下来写个最简单的场景代码。新建一个 .py 文件，内容如下：

from manim import *

class SimpleSquare(Scene):
    def construct(self):
        square = Square()
        self.play(Create(square))
        self.wait(1)

这段代码定义了一个正方形，播放创建动画并暂停一秒。实际运行时，你可以直接在 Cursor 的终端里执行渲染命令：

manim -pql simple_square.py SimpleSquare

参数说明：

• -p：渲染后自动预览
• -q：质量等级（l=低，m=中，h=高，k=4K）
• simple_square.py：文件名
• SimpleSquare：类名

五、避坑指南

1. 路径问题：Windows 用户常遇到 FFmpeg 找不到，务必检查环境变量是否生效，重启终端试试。