manim 安装：4 步搭好环境，跑通第一条数学动画
manim 安装4 步搭好环境跑通第一条数学动画【免费下载链接】manimA community-maintained Python framework for creating mathematical animations.项目地址: https://gitcode.com/GitHub_Trending/man/manim想做出 3Blue1Brown 风格的数学动画第一关是把 manim 安装环境搭起来。下面按 conda 主路径走一遍从系统依赖到第一次渲染顺带把新手最常撞上的报错讲清楚。一分钟认识 manimmanim 是一个用 Python 写数学动画的开源框架你把动画过程写成一个个 Scene它负责把每帧渲染出来并合成成 MP4 视频。它解决的问题是把脑子里的推导过程变成可复现、可逐帧控制的画面公式、坐标、几何变换都能用代码描述。对第一次接触的人只需要会写self.play(...)这种动画调用就能出片。三条安装路径怎么选这一节帮你把 uv、conda、Docker 三条路的定位压缩成一张表按你的使用场景挑一条。路径适合谁依赖谁来管上手体验conda科研机器、日常学习conda 自动打包一条命令装好最省心uv / pip已熟悉 Python 项目需手动补系统库灵活但要懂虚拟环境Docker临时尝鲜、不想污染本机镜像里全含拉镜像即用略吃资源建议默认走 conda它对新手最稳系统依赖基本不用操心。conda 路径manim 环境配置全流程这一节给出 conda 路线的完整可复制命令从建环境到装包。先建一个独立环境并激活。当前 manim 要求 Python 3.11 及以上用 3.12 比较稳机器内存建议 8GB 起、留 2GB 磁盘给缓存和输出。conda create -n manim-env python3.12 conda activate manim-env conda install -c conda-forge manim装完后用健康检查确认环境没问题manim checkhealth关于 manim 系统依赖conda 会把 cairo、pango 这类底层库打包进环境通常你不用额外装。只有当你改走 uv/pip 路线、需要现场编译时才需要系统库命令如下。macOSbrew install cairo pkg-configUbuntu/Debiansudo apt update sudo apt install build-essential python3-dev libcairo2-dev libpango1.0-devFedorasudo dnf install python3-devel pkg-config cairo-devel pango-develArchsudo pacman -Syu base-devel cairo pango其余两条路径uv 与 Docker 速览这一节只给关键命令细节不重复 conda 路径。uv 路线先建项目再把 manim 作为依赖加进去装完用uv run manim checkhealth验证uv init manimations cd manimations uv add manimDocker 路线拉社区镜像把当前目录挂进容器直接渲染docker run --rm -it -v $(pwd):/manim manimcommunity/manim manim -qm test_scenes.py CircleToSquare注意容器里-p预览不可用视频只会写到挂载的目录里。manim LaTeX 配置什么时候才需要装这一节先给判断条件只有当你要渲染数学公式Tex、MathTex时才需要 LaTeX纯文字和几何图形可以跳过。Ubuntu/Debiansudo apt install texlive-fullFedorasudo dnf install texlive-scheme-fullmacOS 装 MacTeX、Windows 装 MiKTeX 发行版图形界面安装即可。manim 第一次渲染跑通第一个场景这一节用一个最小场景验证前面的配置都到位了。新建main.pyfrom manim import * class CreateCircle(Scene): def construct(self): circle Circle() circle.set_fill(PINK, opacity0.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-configUbuntu 装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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考