manim 安装上手3 条命令跑通第一个数学动画【免费下载链接】manimA community-maintained Python framework for creating mathematical animations.项目地址: https://gitcode.com/GitHub_Trending/man/manimmanim 安装卡在依赖上这篇 manim 配置指南带你在 10 分钟内装好环境渲染出第一个动画。 适用人群刚 clone 完仓库、对着 README 和文档目录发懵的新手这篇文章就是给你写的跟着抄命令就行。做科研、天天要在视频里塞数学公式的研究者看第 4 节末尾的 LaTeX 说明就够了。负责 CI 和多机渲染、要求环境可复现的工程师直接把第 7 节的参数抄进流水线。⏱️ 30 秒选路路径适用场景核心命令最大的坑uv推荐常规开发长期写动画uv add manimLinux 要手动装 cairo/pango 开发库conda不想碰系统依赖conda install -c conda-forge manimbase 环境旧版 cairo 与 pycairo 冲突Docker只想要个能渲染的干净环境docker pull manimcommunity/manim镜像里 TeX Live 是精简版不确定就选第 1 条uv坑最少。 主路径uv 安装 manim 完整步骤这节解决从零到能渲染的全部问题按步骤 1 → 步骤 2 → 步骤 3 顺序走。步骤 1克隆仓库并安装 uv超快包管理器uv 比 pip 快一个数量级还能顺手管理 Python 版本manim 官方文档就推荐它。git clone https://gitcode.com/GitHub_Trending/man/manim.git curl -LsSf https://astral.sh/uv/install.sh | shWindows用户第二行换成powershell -ExecutionPolicy ByPass -c irm https://astral.sh/uv/install.ps1 | iex。跑成功的标志终端里uv --version能打印版本号。步骤 2装系统依赖渲染器 cairo/pangomanim 依赖 cairo2D 绘图库和 pango文字排版库Linux需要手动装开发包macOS用 HomebrewWindows则不用装任何东西。# LinuxDebian/Ubuntu sudo apt install build-essential python3-dev libcairo2-dev libpango1.0-dev # macOS brew install cairo pkg-configLinux其他发行版Fedora/Arch 等和Windows的差异见仓库安装文档。跑成功的标志命令无报错终端回到提示符。步骤 3建项目并安装 manim在任意放代码的目录建一个 uv 项目把 manim 加进依赖。uv init manimations cd manimations uv add manim跑成功的标志uv run manim --version打印Manim Community v0.21.0开头那行Manim Community说明装的正是社区版。要渲染数学公式的话这一步后还需装 TeX LiveLaTeX 公式排版系统Windows 装 MiKTeXmacOS 装 MacTeXLinux 执行sudo apt install texlive-full。只画图形不写公式可以跳过。️ 备选路径这节只讲与主路径不同的地方重复步骤不再贴命令。conda 一键安装 manim 环境同上区别在于系统依赖那步整个省掉conda 会把 cairo、pango 等二进制依赖一起打包好。conda create -n manim-env python3.11 conda activate manim-env conda install -c conda-forge manim注意 python 版本要 3.11 起步。坑在于 base 环境的旧版 cairo 和 pycairo 打架报ImportError提到 Symbol 时补一句conda install -c conda-forge pycairo。Docker 容器渲染 manim 场景拉官方镜像把项目目录挂进容器即可环境完全隔离本地什么都不用装。docker pull manimcommunity/manim docker run --rm -it -v $(pwd):/manim manimcommunity/manim manim -qm test_scene.py SquareToCircle坑有两个-p预览和-f打开文件这类标志在容器里用不了镜像自带的是精简 TeX Live渲染中文公式要先在容器里tlmgr install ctex。 跑通与排障先用最小示例确认整个链路是通的。新建test_scene.py内容如下from manim import * class SquareToCircle(Scene): def construct(self): square Square() circle Circle() self.play(Create(square)) self.play(Transform(square, circle)) self.play(FadeOut(square))渲染它uv run manim -ql test_scene.py SquareToCircle。预期输出终端打印绿色 OKmedia/videos/test_scene/480p15/下出现SquareToCircle.mp4。一键自检30 秒确认环境uv run manim checkhealth会列出 Python 版本、系统依赖cairo、pango、ffmpeg的检查结果全绿就是环境 OK。报错先看这张高频坑表报错关键词根因一行修复libcairo.so.2not found系统缺 cairo 库按主路径步骤 2 装系统依赖pango/cairo头文件缺失缺开发头文件sudo apt install libcairo2-dev libpango1.0-devcmanimpango.c编译失败缺 Cython 导致要本地编译 wheeluv pip install Cython后重新uv add manimWindowsmanim不是内部或外部命令命令不在 PATH用uv run manim ...跑LaTeX 渲染失败TeX Live 装太精简装完整包latex --version应能出结果没命中就去安装 FAQ搜报错前 5 个词。 进阶与下一步开发时用-ql边改边渲出片时加-qh -r 3840,2160出 4KCLI 选项参考。同一场景第二次渲染会自动复用缓存秒出--disable_caching可关掉缓存。CI 流水线里建议统一-qh出 1080p排查问题加-v DEBUG看详细日志。输出默认落在media/videos/下按场景名分文件夹可用--custom_folders自定义目录结构。接下来具体做三件事跑一遍 example_scenes/basic.py 里的SquareToCircle官方示例熟悉 Scene 和 Mobject画面元素的写法读 快速入门教程 把第一个自己的场景写出来遇到版本或依赖问题翻 安装 FAQ。【免费下载链接】manimA community-maintained Python framework for creating mathematical animations.项目地址: https://gitcode.com/GitHub_Trending/man/manim创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考