这是一个用于演示如何使用manim的项目。其中分为两大类:python部分以及manim部分。
禁止使用python3.13或往上!!!!!!!!!
本小节面向从未接触过 Python 的同学:先把 Python 与编辑器装好、确认版本无误,再继续下面的 mac/windows Manim 安装流程。
建议你优先选择一种使用方式,避免新手把环境装成“两套”导致混乱:
- 如果你主要在 PyCharm 里运行本项目:以 PyCharm 里选定的 Python 解释器与安装的软件包为准
- 如果你主要在 系统终端 里运行
manim命令:以终端里python/python3对应的环境为准
重要:禁止使用 Python 3.13 或更高版本。
推荐版本:
- Windows:Python 3.10.x(项目 Release 已提供对应安装文件说明)
- macOS:Python 3.10.x 或 3.11.x(建议 3.11.x;如果遇到依赖问题再降到 3.10.x)
Windows 安装(推荐走本项目 Release 的版本):
- 去本项目
ManiumLecture的 Release 页面下载python-3.10.11-amd64.exe - 把安装包放在桌面并双击安装
- 在安装第一页务必勾选 "Add python.exe to PATH"(添加到环境变量/Path)
- 安装后按
Win + R输入cmd回车,运行:
python --versionmacOS 安装:
- 方式 A(官网下载):https://www.python.org/downloads/macos/ 下载
Python 3.11.x(不要 3.13+) - 安装后在「终端」验证:
python3 --version本项目现有步骤里大量使用了 PyCharm 的描述;如果你是完全新手,建议先用 PyCharm。
PyCharm:
- 下载:https://www.jetbrains.com/pycharm/download/
- 推荐:
Community(免费版)
VS Code:
- 下载:https://code.visualstudio.com/
- 建议安装扩展:
Python(Microsoft)
下面 ### mac 安装 里有两种思路:
brew install manim:偏“系统级”,终端里通常能直接用manim- PyCharm 解释器里安装
manim包:偏“项目级”,适合在 PyCharm 里直接运行项目代码
对新手来说:任选一种能成功运行即可,不需要两种都做。
Windows 部分使用 uv 创建/管理环境:建议你在一个固定目录执行(例如桌面或你自己新建的文件夹),避免后面 cd manimations 找不到目录。
在pycharm(下简称pc)终端输入
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"如果显示安装时间过长,请使用镜像源
/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"在pc终端中输入
brew install manim settings-> python-> interpreter-> + ->搜索manim->install package->ok->ok
去ManiumLecture项目的release里面下载python-3.10.11-amd64.exe文件然后放在桌面
在下载页第一页一定要勾选path选项!!!
按win+R启动“运行”。在打开栏输入cmd然后点击确定
运行(打开VPN):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"关掉cmd窗口
按win+R启动“运行”。在打开栏输入cmd然后点击确定
运行(打开VPN):
uv init --python 3.10 manimations
cd manimations
uv add manim去ManiumLecture项目的release里面下载miktexsetup_standalone.exe文件然后放在桌面
安装它(不要更改安装路径)(在最后一页选择检查更新)
过一会会自动提示更新,看见了立即更新
按win+R启动“运行”。在打开栏输入cmd然后点击确定
运行:
cd manimations
uv run manim checkhealth此时所有都应显示为PASS
重新打开PyCharm
按Ctrl+Alt+S进入设置,找到解释器
点击添加解释器 点击添加本地解释器 点击选择现有 点击Python 3.10(刚刚下载的版本) 点击确定 点击左上角的+ 搜索manim 点击安装软件包 点击应用 点击确定
在右下角锁形标志旁选择刚刚配置好的python版本(也有可能自动选择了)
运行代码lecture1中的manim_structure.py文件进行测试
提示为以下正常
C:\Users\10288\AppData\Local\Programs\Python\Python310\lib\site-packages\pydub\utils.py:170: RuntimeWarning: Couldn't find ffmpeg or avconv - defaulting to ffmpeg, but may not work
warn("Couldn't find ffmpeg or avconv - defaulting to ffmpeg, but may not work", RuntimeWarning)首次运行弹出宏包安装窗口,选择安装
接着弹出一个视频则为正常
关掉视频
去ManiumLecture项目的release里面下载ffmpeg-git-essentialse文件然后放在桌面
解压
解压后文件放在C盘根目录(如果你实在是不同意这样做,你可以来找我)
按win+R启动“运行”。在打开栏输入sysdm.cpl然后点击确定
点击高级 点击环境变量 在系统变量中找到Path 点它,然后点编辑 点击新建 填入C:\ffmpeg-git-essentials\bin 连续点击确定直到返回桌面
重启PyCharm
全部完成,恭喜!!!