基于2025年最新情况的Python环境管理之Miniforge3全攻略

文章标题：2025年Python环境管理的Miniforge3全面指南

文章内容：以下是运用 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/cloud
  pytorch: 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/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。

七、注意事项

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

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

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