使用 Miniforge3 管理 Python 环境的详细指南（基于最新实践和时效性信息，截至 2025 年）

以下是使用 Miniforge3 管理 Python 环境的详细指南（基于最新实践和时效性信息，截至 2025 年）：

一、Miniforge3 简介

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

二、安装步骤

1. 下载安装包

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

推荐镜像源
- 南京大学镜像站
- 清华大学开源软件镜像站(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 pyhton=3.12   # 替代conda（推荐）

2. 激活/退出环境

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

conda activate my_env    # 激活环境
conda deactivate        # 退出当前环境# 亦可使用 mamba 替代
# 注意：PowerShell中使用mamba激活环境，使用conda即可；cmd中可正常使用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 加速（推荐）

Why and How 使用Mamba？-> 使用 Mamba 管理 Python 环境

Mamba 是 Conda 的快速替代工具：

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

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

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

Mamba 设置镜像源：清华镜像源

编辑 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/cloudpytorch: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud

例如，我的文件内容：

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/cloudpytorch: 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  # 在新机器上重建环境

时效性提示：以上内容基于 2025 年最新实践，若安装包版本更新，请以 Miniforge 官方文档为准。