Manim 是一个 Python 库,装它之前得先有个能用的 Python。这一篇只做一件事:把 Python 环境装对、验明,并且不把系统搞乱。下一篇再真正安装 Manim、渲染第一个动画。

本文依据 2026 年 11 月的官方信息:Manim Community 0.22.1、Python 3.11~3.14。网上大量教程基于 0.18 以前的版本,版本要求和命令已经对不上了。

一、先搞清楚:该装哪个版本

Manim 0.22.1 在 PyPI 上声明 requires-python = ">=3.11",官方支持矩阵列出的是 3.11、3.12、3.13、3.14。所以下限是 3.11,不是很多老文章写的 3.9。

截至本文写作时,Python 3.15 已经发布(2026 年 10 月),3.10 则已于 2026 年 10 月 1 日结束支持。最新的不一定最合适:官方 classifiers 尚未把 3.15 列进去,部分依赖的预编译包也可能滞后。

版本 状态 建议
3.10 及以下 已停止支持 不用,Manim 也装不上
3.11 / 3.12 安全维护期 可用,兼容性最稳
3.13 / 3.14 缺陷修复期 推荐,新环境优先选
3.15 最新发布 尝鲜可以,遇到依赖报错就退回 3.14
3.16 预览版 不要用

图 1:三平台安装路径与统一验收命令

二、先检查电脑里有没有 Python

很多人其实已经装过,只是不记得。先别急着下载,打开终端查一下。

Windows 用 PowerShell 或终端:

1
2
py --version
python --version

macOS / Linux:

1
python3 --version

只要输出是 Python 3.11.x 到 Python 3.14.x,并且 python -m pip --version 也能正常返回,就可以直接跳到第六节。

如果提示「不是内部或外部命令」、弹出 Microsoft Store,或者版本号低于 3.11,就按下面的步骤装一个新的。

三、Windows 安装(重点)

1. 下载

打开 https://www.python.org/downloads/,点 Download Python 3.14.x,拿到 64 位安装器 python-3.14.x-amd64.exe。

官网速度慢时可以用国内镜像,但要认准来源、核对版本号,别从第三方下载站拿改过的安装包。

2. 安装时的两个关键动作

双击运行,第一屏最下面有两个勾选项:

  • Add python.exe to PATH:必须勾上,这是后面所有命令能跑起来的前提。
  • Use admin privileges when installing py.exe:可勾可不勾,普通用户环境不影响。

建议点 Customize installation 看一眼安装路径,改成不含中文和空格的目录,例如 C:\Python314\。路径里带中文,后面装某些需要本地编译的依赖时容易出怪问题。

截图位 A:安装器首屏,用红框圈出 Add python.exe to PATH。保存为 uploads/allimg/2026/0198/python-installer.png 后,在此处插入 ![安装器首屏](/uploads/allimg/2026/0198/python-installer.png)。

3. 验证

装完新开一个终端窗口(已经开着的窗口不会刷新环境变量),依次执行:

1
2
3
4
python --version
py --version
python -m pip --version
where python

期望看到 Python 3.14.x 和 pip 25.x from ...。最后一条会列出系统找到的解释器路径,用它确认指向的确实是刚装的那一份。

图 2:PATH 的查找过程与两种结果

4. Windows 特有的两个坑

输入 python 却弹出 Microsoft Store。 这是系统的「应用执行别名」在抢命令。打开「设置 → 应用 → 高级应用设置 → 应用执行别名」,把 python.exe 和 python3.exe 关掉,再重开终端。

‘python’ 不是内部或外部命令。 三种解法,按成本从低到高:

1
py --version

如果 py 能用,说明只是 PATH 没配好,日常用 py 启动器也完全可以;想彻底修好,重新运行安装器选 Modify,补勾 Add python.exe to PATH;最后才是手动编辑环境变量 Path,把 C:\Python314\ 和 C:\Python314\Scripts\ 加进去。


四、macOS 与 Linux

macOS 两条路任选其一:从 python.org 下载官方 .pkg 一路下一步;或者用 Homebrew:

1
2
brew install python@3.14
python3 --version

系统自带的那份 Python 不要动、不要删、不要 sudo pip。自己装的版本一律通过 python3 和 python3 -m pip 调用,能避开绝大多数权限与冲突问题。

Linux 多数发行版已经预装 Python 3,先查版本,再补齐虚拟环境组件。

1
python3 --version
1
2
3
4
5
6
7
8
9
# Debian / Ubuntu
sudo apt update
sudo apt install python3 python3-pip python3-venv

# Fedora
sudo dnf install python3 python3-pip

# Arch
sudo pacman -Syu python python-pip

发行版仓库里的 Python 有时偏旧。低于 3.11 就别将就,用 uv 装一个新版本更省事,方法见第八节。


五、认识 pip:包从哪来

pip 是 Python 的包管理器,Manim 就是从 PyPI 通过它装进来的。推荐始终写成 python -m pip,而不是裸 pip:

1
2
3
python -m pip --version
python -m pip install --upgrade pip
python -m pip list

理由是 python -m pip 明确指定了「给当前这个解释器装」,电脑上装了多个 Python 时不会装错地方。macOS / Linux 把 python 换成 python3。

国内网络下可以换镜像源。临时使用:

1
python -m pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple

设为默认(只需一次):

1
python -m pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

换源只影响下载速度,不改变装的是什么包。下一篇若改用 uv,镜像要单独配置,这条 pip 设置不会自动生效。

六、虚拟环境:一个项目一个房间

如果把所有库都装进系统 Python,两个项目要求不同版本的同一个依赖时就会打架。虚拟环境给每个项目单独开一间房,装错了删掉重来,不影响别人。

图 3:系统 Python 与各项目虚拟环境彼此隔离

Windows 创建并激活:

1
2
3
4
python -m venv .venv
.venv\Scripts\activate
python -m pip --version
deactivate

macOS / Linux:

1
2
3
4
python3 -m venv .venv
source .venv/bin/activate
python -m pip --version
deactivate

激活成功后,提示符前面会出现 (.venv)。PowerShell 若提示「无法加载文件,因为在此系统上禁止运行脚本」,只对当前用户放宽策略即可:

1
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

不要为了图省事直接全局 Set-ExecutionPolicy Bypass,那是给整台机器降安全等级。


七、uv:官方现在推荐的工具

Manim 官方文档目前强烈推荐用 uv 管理 Python 环境和依赖。它把「下载 Python、建虚拟环境、装依赖、锁版本」合并成几条命令,速度也比 pip 快一个量级。

Windows PowerShell:

1
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

macOS / Linux:

1
curl -LsSf https://astral.sh/uv/install.sh | sh

装完重开终端,验证并看看能装哪些 Python:

1
2
3
uv --version
uv python list
uv python install 3.14

这里有个容易困惑的点:uv 可以自己下载并管理 Python。既然如此,前面手动装 Python 是不是白做了?并没有 —— PATH、pip、虚拟环境这三件事是理解后续所有报错的基础,uv 只是把它们自动化了。两条路都通,下一篇会同时给出。

八、验收清单

在开始下一篇之前,逐条确认:

检查项 命令 期望结果
解释器版本 python --version Python 3.11~3.14
pip 可用 python -m pip --version 显示 pip 版本号与路径
虚拟环境 python -m venv .venv 目录下生成 .venv
uv(可选) uv --version 显示 uv 版本号
终端刷新 重开终端再执行 结果一致

只要前三行都能跑通,环境就算合格了。

九、常见问题

Q:装了 Anaconda,还需要单独装 Python 吗?

不用。Conda 自带 Python,只要版本 ≥ 3.11 就行。用 conda create -n manim python=3.14 建独立环境即可,但别把 conda 环境和 venv 混着激活。

Q:电脑上同时有 3.11 和 3.14 会冲突吗?

不会。Windows 用 py -3.14 --version 精确指定;macOS / Linux 用 python3.14。真正要避免的是让 pip 指向了另一套解释器,所以坚持写 python -m pip。

Q:公司电脑没有管理员权限怎么办?

Python 官方安装器支持「仅为我安装」,不必管理员权限;uv 也是用户级安装。只有改系统级 PATH 和全局执行策略才需要提权,遇到时用 py 启动器或 python -m 就能绕开。

下一篇

环境就绪后,就可以真正装 Manim 了。下一篇讲 uv、pip、conda 三条安装路线,系统依赖、可选的 LaTeX、checkhealth 体检,以及渲染出第一个正方形变圆的动画。

Manim 入门 · 第二篇:安装 Manim 并渲染第一个动画

参考与配图

本站为非官方个人博客,与 Manim Community 及 3Blue1Brown 无隶属关系。遇到安装问题请以官方文档为准。