使用 Miniforge3 管理 Python 环境的详细指南

使用 Miniforge3 管理 Python 环境的详细指南 | 极客日志

一、Miniforge3 简介

Miniforge3 是一个轻量级 Conda 环境管理工具，默认使用 conda-forge 软件源（社区维护的包更全且更新更快），尤其适配 ARM 架构（如 Apple M1/M2/M3 芯片）。相比 Anaconda，它更精简且兼容性更好。

二、安装步骤

1. 下载安装包

建议通过安装 Miniforge 来实现，Miniforge 默认包含 Mamba。

推荐镜像源
- 南京大学镜像站：https://mirror.nju.edu.cn/help/miniforge
- 清华大学开源软件镜像站：https://mirrors.tuna.tsinghua.edu.cn/github-release/conda-forge/miniforge/
选择最新版本（如 Miniforge3-Linux-x86_64 / Miniforge3-Windows-x86_64.exe / Miniforge3-MacOSX-arm64）

2. 安装

Windows：双击 .exe 文件，安装时勾选'Add to PATH'（自动配置环境变量）。
macOS/Linux：终端执行：

bash Miniforge3-<系统架构>.sh

安装过程中选择安装路径（建议默认），并同意初始化 Conda（输入 yes）。

3. 验证安装

conda --version
# 输出版本号（如 conda 24.1.2）
conda info
# 查看环境信息

三、环境管理

1. 创建新环境

conda create -n my_env python=3.10
# 创建名为 my_env 的 Python 3.10 环境
mamba create -n my_env python=3.12
# 替代 conda（推荐）

2. 激活/退出环境

注意：PowerShell 中使用 mamba 激活环境，使用 conda 即可；cmd 中可正常使用 mamba 进行激活。

conda activate my_env
# 激活环境
conda deactivate
# 退出当前环境

# 亦可使用 mamba 替代
mamba activate my_env
# 激活环境
mamba deactivate
# 退出当前环境

3. 删除环境

conda remove -n my_env --all

四、包管理

1. 安装包

conda install numpy
# 从 conda-forge 安装
pip install package
# 或用 pip（当 conda 源无此包时）

2. 使用 Mamba 加速（推荐）

Mamba 是 Conda 的快速替代工具：

conda install mamba -n base -c conda-forge
# 先安装 mamba
install tensorflow
# 替代 conda install

五、镜像配置（加速下载）

1. 配置清华镜像和默认创建的新环境的路径

编辑 C:\Users\<UserName>\.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
envs_dirs:
  - D:\Miniforge3\envs

六、常见问题

1. Conda 命令失效

原因：环境变量未正确配置。
解决：重新初始化：

~/miniforge3/bin/conda init zsh
# 根据 Shell 类型（bash/zsh）

2. 兼容性问题

ARM 设备（如 M1 Mac）：必须使用 Miniforge3-MacOSX-arm64 版本，避免混合 x86 和 ARM 包。
旧 Anaconda 冲突：卸载 Anaconda 后再安装 Miniforge3。

七、注意事项

避免修改 base 环境：新建独立环境进行操作，防止核心依赖损坏。
环境迁移：

conda env export > environment.yml
# 导出环境配置
conda env create -f environment.yml
# 在新机器上重建环境

若安装包版本更新，请以 Miniforge 官方文档为准。

使用 Miniforge3 管理 Python 环境的详细指南

一、Miniforge3 简介

二、安装步骤

1. 下载安装包

2. 安装

3. 验证安装

三、环境管理

1. 创建新环境

2. 激活/退出环境

3. 删除环境

四、包管理

1. 安装包

2. 使用 Mamba 加速（推荐）

五、镜像配置（加速下载）

1. 配置清华镜像和默认创建的新环境的路径

六、常见问题

1. Conda 命令失效

2. 兼容性问题

七、注意事项

更多推荐文章

相关免费在线工具

使用 Miniforge3 管理 Python 环境的详细指南

一、Miniforge3 简介

二、安装步骤

1. 下载安装包

2. 安装

3. 验证安装

三、环境管理

1. 创建新环境

2. 激活/退出环境

3. 删除环境

四、包管理

1. 安装包

2. 使用 Mamba 加速（推荐）

五、镜像配置（加速下载）

1. 配置清华镜像和默认创建的新环境的路径

六、常见问题

1. Conda 命令失效

2. 兼容性问题

七、注意事项

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具