企业官网建设流程全解析

如何安装 manim：三条路线搭好数学动画环境，附常见卡点自查

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

manim 是一个社区维护的 Python 数学动画框架，能把公式、几何图形和推理过程逐帧渲染成视频，是做数学可视化最常用的工具之一。本文面向刚接触 manim、想在本机或容器里把它跑起来的新手和普通用户，重点放在安装、依赖和验收。

它本身不难装，坑基本都出在系统级依赖（cairo、pango）和 LaTeX 这两块。把这两块理清，后面写场景就顺了。

开始安装前，先确认这 4 项

• Python 版本 3.8 及以上。
• 内存至少 4GB RAM，推荐 8GB 以上。
• 磁盘留出至少 2GB 可用空间。
• 显卡支持 OpenGL 3.3 及以上，OpenGL 是 manim 做 GPU 渲染的基础。

先选一条适合你的安装路线

如果你只是想先跑起来看看效果，直接走 uv/pip 这条路最省事，后面推荐路线会把它一步步讲透。

如果你是长期做数学研究、需要环境稳定且依赖互相不打架，选 conda/mamba，它会自动帮你把系统依赖一起解决好。

如果你不想把任何包写进本机环境，或者要给团队一个完全一致的运行环境，Docker 是最干净的方案，代价是资源占用更高。

用 uv 快速安装 manim（推荐）

uv 是新一代 Python 包管理工具，比传统 pip 更快，官方安装文档 以它为主线。先在你的系统上装好 uv 工具本身：

# macOS/Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

uv 装好后，给它开一个独立的项目目录，再把 manim 加进这个环境：

# 创建 manim 项目目录 uv init my-manim-project cd my-manim-project # 安装 manim uv add manim

包装好了，还差最后一块：系统级依赖。不同发行版的包名不一样，按你用的系统挑一组执行：

macOS：

# 使用 Homebrew 安装依赖 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 Linux：

sudo pacman -Syu base-devel cairo pango

备选路线：conda 隔离环境与 Docker 快速体验

conda / mamba 隔离环境

选它的理由：一个命令就能把 Python 和系统依赖一起装齐，适合长期科研环境。mamba 是 conda 的加速版，命令一一对应。

# 创建 conda 环境 conda create -n manim-env python=3.10 conda activate manim-env # 安装 manim conda install -c conda-forge manim

用 mamba 的话把命令换成：

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

Docker 快速体验

选它的理由：环境完全隔离、跨机器一致，拉下来直接就能渲染。Docker 安装文档 有更完整的参数说明。

# 拉取最新 manim 镜像 docker pull manimcommunity/manim:latest # 运行示例场景 docker run --rm -it -v "$(pwd):/manim" manimcommunity/manim manim -qm example_scenes.py SquareToCircle

配置 LaTeX 让数学公式渲染起来

LaTeX 是渲染数学公式的引擎，manim 遇到Tex时会调用它。它是可选项，但想要漂亮的公式就得装。

Windows：下载安装 MiKTeX。

macOS：下载安装 MacTeX。

Linux：

# Ubuntu/Debian sudo apt install texlive-full # Fedora sudo dnf install texlive-scheme-full # Arch Linux sudo pacman -S texlive-most

30 秒验收 manim 安装

先跑一次健康检查，它会逐项报告环境是否齐备：

manim checkhealth

再建一个最小测试场景test.py，确认渲染管线真的能出画面：

from manim import * class TestScene(Scene): def construct(self): circle = Circle() square = Square() self.play(Create(square)) self.play(Transform(square, circle)) self.play(FadeOut(square))

用低质量参数渲染它，能正常出视频就说明环境通了：

manim -pql test.py TestScene

让 manim 渲染更快一点

• 用 SSD 存工程和缓存，读帧速度会明显提升。
• 开发调试时加-ql跑低质量，正式出片再切高清。
• 依赖 manim 自带的帧缓存，重复渲染相同内容时会自动复用。
• 多核机器上开启多线程渲染，吃满 CPU。

安装卡住了怎么排查

症状：ImportError: libcairo.so.2。 原因：系统里没装 cairo 这个图形库。 解决：装上对应发行版的 cairo 开发包，Ubuntu 执行sudo apt install libcairo2-dev，CentOS 执行sudo yum install cairo-devel。

症状：LaTeX 渲染报错、公式出不来。 原因：LaTeX 没装，或装了但缺宏包。 解决：先用latex --version确认有没有装，确认装了再按报错补包sudo tlmgr install <package-name>。

症状：安装或写缓存时遇到权限报错。 原因：直接往系统级 Python 环境里写，权限不够。 解决：改用虚拟环境，uv venv建一个，再source .venv/bin/activate激活。

跑通之后

去example_scenes/里挑一个官方场景试渲染，例如manim -pql example_scenes/basic.py SquareToCircle，能出视频就代表整条链路都通了。遇到装不上的依赖或渲染异常，可以去 manim 社区的 Discord 或 Reddit 提问，社区很活跃，通常当天就有人接。

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