数学视频动画引擎Python库 -- Manim 安装指南 Installing Manim locally-优快云博客

文中内容仅限技术学习与代码实践参考，市场存在不确定性，技术分析需谨慎验证，不构成任何投资建议。

Mathematical Animation Engine
Manim 绘制函数图象示例

本地安装 Manim

安装 Manim 的标准方式是使用 Python 的包管理器 pip，从 PyPI 安装最新版本。

为了方便你遵循设置 Python 项目用于 Manim 动画的最佳实践，我们强烈推荐使用管理 Python 环境和依赖的工具。特别是，我们强烈推荐使用 uv。

对于以下描述的两种主要安装 Manim 的方式，我们假设 uv 是可用的；如果你对 Python 或编程不太熟悉，我们觉得它特别有帮助。这绝不是硬性要求；如果你知道自己在做什么，你可以直接使用 pip 安装 Manim。

安装 Python 管理工具 `uv`

安装 uv 的一种方式是通过专用的控制台安装程序，支持所有大型操作系统。只需将以下代码片段粘贴到你的终端/PowerShell 中——或者查阅 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"

当然，如果你知道自己在做什么，并且更愿意自己设置虚拟环境，那么请随意！

重要提示

如果你在按照下面的说明操作时遇到问题，请不要担心：查看我们的安装常见问题解答，看看问题是否已经得到解决——如果没有，请查看如何联系我们的社区以获得帮助。

安装

第一步：安装 Python

我们首先需要检查你的机器上是否安装了合适版本的 Python。打开终端运行

uv python install

以安装最新版本的 Python。如果安装成功，请继续下一步。

第二步（可选）：安装 LaTeX

LaTeX 是一个非常著名且广泛使用的排版系统，允许你编写如下公式：

$\begin{equation*} \frac{1}{2\pi i} \oint_{\gamma} \frac{f(z)}{(z - z_0)^{n+1}}~dz = \frac{f^{(n)}(z_0)}{n!}. \end{equation*}$

如果你只需要渲染纯文本，且不想渲染任何排版公式，那么你可以跳过这一步。否则，请从下面的标签列表中选择你的操作系统，并按照说明操作。

Windows

对于 Windows，我们推荐通过 MiKTeX 发行版安装 LaTeX。只需从它们的下载页面 https://miktex.org/download 获取 Windows 安装程序并运行它。

MacOS

如果你使用的是 MacOS，我们推荐安装 MacTeX 发行版。可以从 https://www.tug.org/mactex/mactex-download.html 下载最新的 PKG 文件，并按照标准安装程序进行操作。

Linux

鉴于 Linux 发行版众多，且安装包的方式各不相同，我们无法为所有包管理器提供详细的安装说明。

一般来说，我们推荐安装 TeX Live 发行版（https://www.tug.org/texlive/）。对于大多数 Linux 发行版，TeX Live 已经被打包，可以通过你的系统包管理器轻松安装。在互联网和你常用的 OS 资源中搜索详细的说明。

例如，在基于 Debian 的系统上，使用包管理器 apt，可以通过运行以下命令安装完整的 TeX Live 发行版：

sudo apt install texlive-full

对于 Fedora（通过 dnf 管理），相应的命令是：

sudo dnf install texlive-scheme-full

安装 LaTeX 后，继续安装 Manim 本身。

你可以使用更小、更可定制的 LaTeX 发行版，如 TinyTeX。Manim 总体上需要在你的发行版中安装以下 LaTeX 包：

amsmath babel-english cbfonts-fd cm-super count1to ctex doublestroke dvisvgm everysel fontspec frcursive fundus-calligra gnu-freefont jknapltx latex-bin mathastext microtype multitoc physics preview prelim2e ragged2e relsize rsfs setspace standalone tipa wasy wasysym xcolor xetex xkeyval

第三步：安装 Manim

这些步骤在不同操作系统之间略有不同。请确保从下面的标签列表中选择正确的操作系统，然后按照说明操作。

MacOS 和 Windows

以下命令将

创建一个新的 Python 项目目录，
并添加 Manim 作为依赖项，将其安装到相应的本地 Python 环境中。

Python 项目的名称是 manimations，你可以将其更改为任何你喜欢的名称。

uv init manimations
cd manimations
uv add manim

Manim 现在已安装在你的本地项目环境中！

Linux

实际上，MacOS 和 Windows 标签中给出的说明也适用于 Linux——然而，Linux 用户需要从源代码构建 ManimPango（以及可能的 pycairo），因此需要一些额外的依赖项。具体来说，这包括：

C 编译器，
Python 的开发头文件，
pkg-config 工具，
Pango 及其开发头文件，
以及 Cairo 及其开发头文件。

以下是一些流行系统/包管理器的说明。

Debian-based / apt

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

Fedora / dnf

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

Arch Linux / pacman

sudo pacman -Syu base-devel cairo pango

安装所需的依赖项后，你可以通过运行以下命令创建一个 Python 项目（你可以随意更改下面使用的名称 manimations），并在本地环境中包含 Manim：

uv init manimations
cd manimations
uv add manim

要验证你的本地 Python 项目是否设置正确，以及 Manim 是否可用，只需运行

此时，你也可以使用你喜欢的 IDE 打开项目文件夹。所有现代 Python IDE（例如带有 Python 扩展的 VS Code 或 PyCharm）都应该能够自动检测由 uv 创建的本地环境，因此如果你在新文件 my-first-animation.py 中放入

那么导入将正确解析，并且提供自动补全。

快乐地制作 Manim 动画吧！

如果你有多个不同目录的 Manim 项目，并且不想为每个项目都设置本地项目环境，那么你也可以将 Manim 安装为一个由 uv 管理的工具。

参阅 uv 的文档，了解有关它们工具机制的更多信息。

要将 Manim 安装为全局 uv 工具，只需运行

uv tool install manim

之后，manim 可执行文件将在你的全局系统路径上可用，无需激活任何虚拟环境或在命令前加上 uv run。

请注意，使用这种方法时，设置代码编辑器以正确解析 import manim 需要额外的工作，因为全局工具环境不会自动被检测到：可以通过运行

uv tool dir

来确定所有工具环境的基路径，它现在应该包含一个名为 manim 的目录，其中包含适当的虚拟环境。将你的 IDE 的 Python 解释器设置为这个环境，以使导入正确解析。

如果你想要使用不同版本的 Python（例如，由于与其他包存在兼容性问题），那么 uv 允许你以一种相当直接的方式进行操作。

在初始化本地 Python 项目时，只需将你想要使用的 Python 版本作为参数传递给 init 命令：

uv init --python 3.12 manimations
cd manimations
uv add manim

要更改现有包的版本，你需要编辑 pyproject.toml 文件。如果你正在降级 Python 版本，那么需要更新 requires-python 条目，使你选择的版本满足要求。将该行更改为，例如 requires-python = ">=3.12"。之后，运行 uv python pin 3.12 将 Python 版本锁定为 3.12。最后，运行 uv sync，你的环境就会更新！