我的虚拟环境名称为manimce,请自行替换
一、miniforge
miniforge南大镜像站:https://mirror.nju.edu.cn/github-release/conda-forge/miniforge/LatestRelease/
M系芯片下载arm64版,intel下载x86_64版
1. 用终端进入下载目录
cd ~/Downloads
2. 给 .sh
文件添加执行权限
(替换为你下载的文件名)
chmod +x Miniforge3-24.11.3-2-MacOSX-arm64.sh
3. 运行安装脚本
./Miniforge3-24.11.3-2-MacOSX-arm64.sh
4. 按照安装提示操作
-
安装程序会显示许可协议,按 空格键 翻页,然后输入
yes
同意。 -
它会询问安装路径,默认是
~/miniforge3
,直接回车即可(除非你有特殊需求)。 -
安装完成后,它会询问是否要初始化 Conda,输入
yes
。
5. 让更改生效
source ~/.zshrc
6. 手动初始化 Conda
Miniforge3 安装时应该会自动修改 Shell 配置文件(~/.zshrc
或 ~/.bashrc
),但如果没有生效,可以手动初始化:
~/miniforge3/bin/conda init zsh
然后关闭终端,重新打开,或者运行:
source ~/.zshrc
7. 验证安装
conda --version
如果显示版本号(如 conda 24.11.3
),说明安装成功!
8. 使用 Miniforge3
-
创建新环境:
conda create -n manimce python=3.12
-
激活环境:
conda activate manimce
二、vscode
安装插件python和python debugger
设置虚拟环境中的解释器
~/miniforge3/envs/manimce/bin/python
在vscode终端激活虚拟环境
conda activate manimce
三、conda
conda清华源:https://mirrors.tuna.tsinghua.edu.cn/help/anaconda/
1. 创建或修改 ~/.condarc
文件
-
打开终端,运行以下命令编辑
~/.condarc
文件:nano ~/.condarc
-
将以下内容复制到文件中(覆盖原有内容):
channels: - defaults show_channel_urls: true default_channels: - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2 custom_channels: conda-forge: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud pytorch: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud msys2: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud bioconda: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud menpo: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud simpleitk: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
-
Ctrl+O
保存,Ctrl+X
退出编辑器。
2. 清除 Conda 缓存
-
运行以下命令确保配置生效:
conda clean -i
3. 验证配置
-
检查当前使用的源:
conda config --show channels
输出应包含清华镜像地址。
-
测试安装包(如
numpy
):conda install numpy
观察下载速度是否来自清华镜像。
四、ffmpeg
1. 初始化 Mamba(修复 mamba activate
问题)
mamba init
然后 关闭并重新打开终端(或运行 source ~/.zshrc
使更改生效)。
2. 检查 Shell 类型
-
macOS 默认 Shell 现在是
zsh
,但mamba init
可能修改的是~/.bash_profile
。-
如果你用
zsh
,需要同步配置:echo 'source ~/.bash_profile' >> ~/.zshrc source ~/.zshrc
-
或直接为
zsh
初始化:mamba init zsh source ~/.zshrc
-
3. 安装 ffmpeg(激活环境后)
mamba install ffmpeg -c conda-forge
或
conda install ffmpeg -c conda-forge
五、pip、manim
pip清华源:https://mirrors.tuna.tsinghua.edu.cn/help/pypi/
1. 设为默认
升级 pip 到最新的版本后进行配置:
python -m pip install --upgrade pip pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple
2. 安装 Manim
pip install manim[full] --pre
3. 验证安装
manim --version
如果安装manim
失败,原因是manim
依赖的 pycairo
包在安装时编译失败(常见于 macOS)
解决方案
1. 恢复 pip 清华源(确保已生效)
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
验证配置:
pip config list
应显示:
global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple'
2. 安装 Xcode 命令行工具(必需)
pycairo
需要编译,依赖 macOS 开发工具:
xcode-select --install
点击弹窗中的 “安装”,完成后重启终端。
3. 安装 Homebrew
方使用官方脚本安装(推荐)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后,终端会提示你执行以下命令(务必执行!):
(类似这样,具体路径可能不同)
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc source ~/.zshrc
这样会把 brew
的路径添加到 $PATH
。
4. 验证 brew
是否可用
brew --version
如果显示版本号(如 Homebrew 4.2.0
),说明安装成功。
5. 安装 cairo
和 pkg-config
(继续 Manim 安装)
brew update brew install cairo pkg-config
然后继续安装 pycairo
和 manim
:
pip install pycairo --no-cache-dir pip install manim
6. 验证 manim
是否安装成功
manim --version