企业官网建设流程全解析

manim 安装：4 步搭好环境，跑通第一条数学动画

【免费下载链接】manimA community-maintained Python framework for creating mathematical animations.项目地址: https://gitcode.com/GitHub_Trending/man/manim

想做出 3Blue1Brown 风格的数学动画，第一关是把 manim 安装环境搭起来。下面按 conda 主路径走一遍，从系统依赖到第一次渲染，顺带把新手最常撞上的报错讲清楚。

一分钟认识 manim

manim 是一个用 Python 写数学动画的开源框架：你把动画过程写成一个个 Scene，它负责把每帧渲染出来并合成成 MP4 视频。它解决的问题，是把"脑子里的推导过程"变成可复现、可逐帧控制的画面，公式、坐标、几何变换都能用代码描述。对第一次接触的人，只需要会写self.play(...)这种动画调用，就能出片。

三条安装路径怎么选

这一节帮你把 uv、conda、Docker 三条路的定位压缩成一张表，按你的使用场景挑一条。

建议默认走 conda：它对新手最稳，系统依赖基本不用操心。

conda 路径：manim 环境配置全流程

这一节给出 conda 路线的完整可复制命令，从建环境到装包。

先建一个独立环境并激活。当前 manim 要求 Python 3.11 及以上，用 3.12 比较稳；机器内存建议 8GB 起、留 2GB 磁盘给缓存和输出。

conda create -n manim-env python=3.12 conda activate manim-env conda install -c conda-forge manim

装完后用健康检查确认环境没问题：

manim checkhealth

关于 manim 系统依赖：conda 会把 cairo、pango 这类底层库打包进环境，通常你不用额外装。只有当你改走 uv/pip 路线、需要现场编译时才需要系统库，命令如下。

macOS：

brew install cairo pkg-config

Ubuntu/Debian：

sudo apt update sudo apt install build-essential python3-dev libcairo2-dev libpango1.0-dev

Fedora：

sudo dnf install python3-devel pkg-config cairo-devel pango-devel

Arch：

sudo pacman -Syu base-devel cairo pango

其余两条路径：uv 与 Docker 速览

这一节只给关键命令，细节不重复 conda 路径。

uv 路线先建项目再把 manim 作为依赖加进去，装完用uv run manim checkhealth验证：

uv init manimations cd manimations uv add manim

Docker 路线拉社区镜像，把当前目录挂进容器直接渲染：

docker run --rm -it -v "$(pwd):/manim" manimcommunity/manim manim -qm test_scenes.py CircleToSquare

注意容器里-p（预览）不可用，视频只会写到挂载的目录里。

manim LaTeX 配置：什么时候才需要装

这一节先给判断条件：只有当你要渲染数学公式（Tex、MathTex）时才需要 LaTeX，纯文字和几何图形可以跳过。

Ubuntu/Debian：

sudo apt install texlive-full

Fedora：

sudo dnf install texlive-scheme-full

macOS 装 MacTeX、Windows 装 MiKTeX 发行版，图形界面安装即可。

manim 第一次渲染：跑通第一个场景

这一节用一个最小场景验证前面的配置都到位了。新建main.py：

from manim import * class CreateCircle(Scene): def construct(self): circle = Circle() circle.set_fill(PINK, opacity=0.5) self.play(Create(circle))

在项目目录里渲染：

manim -pql main.py CreateCircle

-ql是低质量快速档，-p表示渲染完自动播放。成功的话，终端打印渲染信息后生成一个 MP4 并弹出播放，画面是一个半透明粉色圆被画出来。跑通这一步，说明 manim 环境配置就算落地了。

manim 报错速查

这一节按关键词收三条新手高频报错，每条按"看到 X → 通常是 Y → 执行 Z"处理。

看到ImportError: libcairo.so.2→ 通常是缺 cairo 系统库 → 执行上面对应系统的 cairo 安装命令（macOS 是brew install cairo pkg-config，Ubuntu 装libcairo2-dev）。

看到 LaTeX 渲染失败、报找不到 latex → 通常是没有安装或包不全 → 执行sudo apt install texlive-full补全 TeX Live。

看到permission denied→ 通常是全局安装被拒 → 执行 conda/uv 建独立环境再装，不要用 sudo 硬装。

装好之后可以按 官方 conda 安装文档 核对细节，再顺着 uv 安装文档 看进阶用法。遇到卡点可以去官方文档站或社区渠道提问，照着上面的报错速查先自查一遍，大多能自己解决。下一步建议打开 示例场景目录，挑一个简单的 Scene 渲染，边看边改。

【免费下载链接】manimA community-maintained Python framework for creating mathematical animations.项目地址: https://gitcode.com/GitHub_Trending/man/manim