还在用 Anaconda？Miniforge：conda-forge 官方极简安装器，内置 Mamba，6 大架构全覆盖，5 分钟从零搭建 Python 环境

💡 还在装几百 MB 的 Anaconda？还在为 defaults 频道和 conda-forge 频道冲突头疼？Miniforge 就是答案：conda-forge 社区官方出品的极简安装器，默认只配置 conda-forge 单一频道，零冲突；内置 conda + mamba 双引擎，解析依赖速度飞升；支持 x86_64 / aarch64 / Apple Silicon / ppc64le 6 大架构；Windows / macOS / Linux 三平台 + WSL 全覆盖；macOS 还提供签名公证的 PKG 安装包；一行命令装完就能用，CI/CD 自动化友好。BSD 3-Clause 开源，Mambaforge 已退役，Miniforge3 是唯一的官方推荐。Python 数据科学环境搭建，从今天开始只需要一个安装器。

📌 目录

[1. Miniforge 是什么？](#1. Miniforge 是什么？)
[2. 为什么选 Miniforge 而不是 Anaconda / Miniconda？](#2. 为什么选 Miniforge 而不是 Anaconda / Miniconda？)
[3. 安装指南：三大平台全覆盖](#3. 安装指南：三大平台全覆盖)
[4. 安装后必做 3 件事](#4. 安装后必做 3 件事)
[5. conda vs mamba：双引擎对比](#5. conda vs mamba：双引擎对比)
[6. 环境管理实战](#6. 环境管理实战)
[7. CI/CD 集成最佳实践](#7. CI/CD 集成最佳实践)
[8. 完整平台与架构矩阵](#8. 完整平台与架构矩阵)
[9. 卸载与清理](#9. 卸载与清理)
[10. Mambaforge 退役说明](#10. Mambaforge 退役说明)
[11. 优缺点与使用建议](#11. 优缺点与使用建议)
[12. 总结](#12. 总结)

1. Miniforge 是什么？

Miniforge 是 conda-forge 社区官方维护的极简 Conda/Mamba 安装器，专为纯净、高效的 Python 环境管理而设计。

🔗 项目地址：https://github.com/conda-forge/miniforge
📜 许可证：BSD 3-Clause
🏢 维护方：conda-forge 社区
📌 当前版本：Python 3.13 基础环境

核心原则

复制代码

Miniforge 的设计哲学：

  1. 极简 → 只装 conda + mamba，不塞额外包
  2. 纯净 → 只配置 conda-forge 频道，零冲突
  3. 全平台 → Windows / macOS / Linux / WSL
  4. 全架构 → x86_64 / aarch64 / Apple Silicon / ppc64le
  5. 稳定 → CI 自动构建 + 自动测试多发行版

一句话总结

复制代码

Miniforge = conda-forge 官方安装器
         = 极简（只装 conda + mamba）
         = 纯净（默认只有 conda-forge 频道）
         = 全平台 + 全架构
         = Anaconda 的最佳替代

2. 为什么选 Miniforge 而不是 Anaconda / Miniconda？

三者对比

对比维度	Miniforge	Miniconda	Anaconda
安装体积	~80MB	~80MB	~3GB
包管理器	conda + mamba	conda	conda
默认频道	conda-forge（唯一）	defaults	defaults
频道冲突	零冲突	经常冲突	经常冲突
包数量	conda-forge 25万+	defaults 较少	defaults + 附加包
包更新速度	快（社区驱动）	慢	慢
Apple Silicon	原生支持	有限	有限
ppc64le	支持	有限	有限
商业使用	完全免费	需关注条款	企业版付费
适合场景	所有人	基础用户	初学者

为什么 conda-forge 频道更好？

复制代码

Anaconda defaults 频道：
  ❌ 包数量少，更新慢
  ❌ 与 conda-forge 同时使用会产生依赖冲突
  ❌ 商业使用可能需要许可

conda-forge 频道（Miniforge 默认唯一）：
  ✅ 25万+ 包，社区驱动，更新最快
  ✅ 单一频道，零冲突
  ✅ 完全免费，无商业限制
  ✅ 质量由社区 feedstock 严格审查

关键优势

优势	说明
🔥 内置 mamba	依赖解析速度比 conda 快 10x+
🔥 单一频道	conda-forge only，杜绝频道冲突
🔥 全架构	x86_64 + aarch64 + ppc64le + Apple Silicon
🔥 CI 友好	一行命令静默安装，自动化流水线首选
🔥 macOS PKG	2026 年起提供签名公证 PKG 安装包
🔥 社区驱动	conda-forge 社区 3000+ 贡献者维护

3. 安装指南：三大平台全覆盖

Windows

powershell 复制代码

# 下载安装器
# https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Windows-x86_64.exe

# 图形界面安装：双击 exe，按提示操作
# 推荐：勾选"Create start menu shortcuts"
# 通过"Miniforge Prompt"使用 conda/mamba

# 静默安装（CI/自动化）
start /wait "" Miniforge3-Windows-x86_64.exe /InstallationType=JustMe /RegisterPython=0 /S /D=%UserProfile%\Miniforge3

⚠️ Windows 注意事项：

默认只在"Miniforge Prompt"中可用，其他终端需运行 conda init

安装路径避免特殊字符和空格（如中文用户名）

可手动将 C:\Users\用户名\miniforge3\condabin\ 加入 PATH

Linux / WSL

bash 复制代码

# 一行下载（自动识别架构）
curl -L -O "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh"

# 交互式安装
bash Miniforge3-$(uname)-$(uname -m).sh

# 静默安装（CI/自动化）
bash Miniforge3-$(uname)-$(uname -m).sh -b

# 安装后初始化
~/miniforge3/bin/conda init

💡 WSL 用户：确保在 Linux 终端（非 PowerShell）中执行 Linux 安装器！

macOS

bash 复制代码

# 方式 1：SH 安装器（推荐，支持自动化）
curl -L -O "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-MacOSX-$(uname -m).sh"
bash Miniforge3-MacOSX-$(uname -m).sh

# 方式 2：PKG 安装器（2026 年新增，签名公证）
# Apple Silicon：
#   下载 Miniforge3-MacOSX-arm64.pkg，双击安装
# Intel：
#   下载 Miniforge3-MacOSX-x86_64.pkg，双击安装

💡 macOS PKG 安装器由 NumFOCUS 证书签名和公证，安全可信！
⚠️ 不推荐通过 Homebrew 安装 Miniforge，存在兼容性问题！

4. 安装后必做 3 件事

第 1 步：初始化 shell

bash 复制代码

# 初始化 conda（让 conda/mamba 在任意终端可用）
conda init

# 如果用的是 zsh
conda init zsh

# 如果用的是 fish
conda init fish

第 2 步：关闭自动激活 base

bash 复制代码

# 关闭 base 环境自动激活（推荐！避免污染系统 Python）
conda config --set auto_activate_base false

# 需要时手动激活
conda activate

第 3 步：验证安装

bash 复制代码

# 检查 conda
conda --version
# 输出示例：conda 25.x.x

# 检查 mamba
mamba --version
# 输出示例：mamba 2.x.x

# 检查频道配置
conda config --show channels
# 应该只有：conda-forge

5. conda vs mamba：双引擎对比

Miniforge 同时内置 conda 和 mamba 两个包管理命令：

对比维度	conda	mamba
依赖解析	经典求解器	libsolv（极快）
解析速度	慢（复杂环境数十秒）	快 10x+（秒级）
安装命令	`conda install`	`mamba install`
创建环境	`conda create`	`mamba create`
搜索包	`conda search`	`mamba search`
兼容性	100%	100%（完全兼容）
推荐场景	简单安装	复杂依赖 / 大环境

复制代码

日常使用建议：

  简单安装 1-2 个包 → conda install xxx
  复杂环境 / 依赖冲突 → mamba install xxx（秒解！）
  CI 流水线 → mamba（快速可靠）

💡 Miniforge 自 2023 年 8 月起内置 conda-libmamba-solver，conda 本身也开始使用 libmamba 后端解析依赖，速度已大幅提升！

6. 环境管理实战

创建新环境

bash 复制代码

# 基础创建
conda create -n my_project python=3.12

# 创建时直接装包（推荐！一次解析所有依赖）
conda create -n data_science python=3.12 jupyterlab numpy pandas matplotlib scikit-learn

# 用 mamba 创建（更快）
mamba create -n ml_project python=3.12 pytorch torchvision torchaudio

# 从 YAML 文件创建
conda env create -f environment.yml

激活 / 退出环境

bash 复制代码

# 激活
conda activate my_project

# 退出
conda deactivate

# 查看所有环境
conda env list

安装包

bash 复制代码

# conda 安装
conda install numpy pandas

# mamba 安装（推荐复杂场景）
mamba install pytorch torchvision -c pytorch

# pip 安装（conda 找不到的包）
pip install some-package

导出 / 复现环境

bash 复制代码

# 导出环境
conda env export > environment.yml

# 从导出文件创建
conda env create -f environment.yml

# 克隆环境
conda create --name my_clone --clone my_project

典型环境模板

yaml 复制代码

# environment.yml - 数据科学项目
name: data_science
channels:
  - conda-forge
dependencies:
  - python=3.12
  - jupyterlab
  - numpy
  - pandas
  - matplotlib
  - scikit-learn
  - seaborn
  - pip:
    - kaggle

yaml 复制代码

# environment.yml - PyTorch 深度学习项目
name: pytorch_project
channels:
  - conda-forge
dependencies:
  - python=3.12
  - pytorch
  - torchvision
  - torchaudio
  - cuda-version=12.4
  - pip:
    - transformers
    - datasets
    - accelerate

7. CI/CD 集成最佳实践

GitHub Actions

yaml 复制代码

# .github/workflows/test.yml
name: Test
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup Miniforge
        uses: conda-incubator/setup-miniconda@v3
        with:
          miniforge-version: latest
          use-mamba: true
          activate-environment: test
          environment-file: environment.yml

      - name: Run tests
        shell: bash -l {0}
        run: |
          python -m pytest

手动 CI 安装

bash 复制代码

# Linux CI
wget -O Miniforge3.sh "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh"
bash Miniforge3.sh -b -p "${HOME}/conda"
source "${HOME}/conda/etc/profile.d/conda.sh"
source "${HOME}/conda/etc/profile.d/mamba.sh"
conda activate

# macOS CI
curl -fsSLo Miniforge3.sh "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-MacOSX-$(uname -m).sh"
bash Miniforge3.sh -b -p "${HOME}/conda"
source "${HOME}/conda/etc/profile.d/conda.sh"
conda activate

Docker 集成

dockerfile 复制代码

FROM condaforge/mambaforge:latest

COPY environment.yml .
RUN mamba env create -f environment.yml && \
    mamba clean -afy

SHELL ["conda", "run", "-n", "myenv", "/bin/bash", "-c"]
CMD ["conda", "run", "-n", "myenv", "python", "app.py"]

8. 完整平台与架构矩阵

当前支持（Python 3.13）

OS	架构	最低版本	安装文件
Linux	x86_64 (amd64)	glibc >= 2.17	`Miniforge3-Linux-x86_64.sh`
Linux	aarch64 (arm64)	glibc >= 2.17	`Miniforge3-Linux-aarch64.sh`
Linux	ppc64le (POWER8/9)	glibc >= 2.17	`Miniforge3-Linux-ppc64le.sh`
macOS	x86_64 (Intel)	macOS >= 11.0	`Miniforge3-MacOSX-x86_64.sh` / `.pkg`
macOS	arm64 (Apple Silicon)	macOS >= 11.0	`Miniforge3-MacOSX-arm64.sh` / `.pkg`
Windows	x86_64	Windows >= 10	`Miniforge3-Windows-x86_64.exe`

特殊硬件说明

硬件	说明
Raspberry Pi	需 64 位处理器 + 64 位 OS（如 Raspberry Pi OS 64-bit / Ubuntu for RPi）
Apple Silicon (M1/M2/M3/M4)	原生支持，PKG 安装包已签名公证
POWER8/9	ppc64le 架构完整支持

旧系统支持

系统	最低版本	可用版本
macOS 10.13-10.15	---	26.1.1-3
macOS 10.9-10.12	---	24.3.0-0
glibc 2.12-2.16	---	24.3.0-0

9. 卸载与清理

完整卸载三步走

bash 复制代码

# 步骤 1：撤销 shell 修改（先看会改哪些文件）
conda init --reverse --dry-run

# 确认后执行
conda init --reverse
# ⚠️ 先别关终端！完成步骤 2 和 3 后再关

# 步骤 2：删除安装目录
CONDA_BASE_ENVIRONMENT="$(conda info --base)"
echo "将删除：${CONDA_BASE_ENVIRONMENT}"
# ⚠️ 确认路径正确后再执行
rm -rf "${CONDA_BASE_ENVIRONMENT}"

# 步骤 3：删除配置文件
rm -f "${HOME}/.condarc"
rm -fr "${HOME}/.conda"

⚠️ 卸载操作不可逆！务必先确认路径正确！

10. Mambaforge 退役说明

时间线

时间	事件
2023.08	Miniforge 23.3.1 起，Miniforge 和 Mambaforge 功能完全一致
2024.07	Mambaforge 官方宣布退役
2024.10	Mambaforge 安装器开始间歇性拒绝安装（brownout）
2025.01	Mambaforge 安装器永久拒绝安装，停止新版本发布

为什么退役？

复制代码

2023.08 之前：
  Miniforge → 只装 conda
  Mambaforge → 装 conda + mamba
  
2023.08 之后：
  Miniforge → 装 conda + mamba + conda-libmamba-solver
  Mambaforge → 装 conda + mamba + conda-libmamba-solver
                    ↑ 完全一样！唯一的区别是安装器名字和默认路径

结论：两个安装器功能完全重复 → Mambaforge 退役 → Miniforge3 是唯一推荐

💡 如果你还在用 Mambaforge，立即迁移到 Miniforge3！安装后修改默认路径即可。

11. 优缺点与使用建议

✅ 优点

维度	评分	说明
极简	⭐⭐⭐⭐⭐	只装 conda + mamba，干净利落
纯净	⭐⭐⭐⭐⭐	默认只有 conda-forge 频道，零冲突
速度	⭐⭐⭐⭐⭐	内置 mamba，依赖解析秒级
跨平台	⭐⭐⭐⭐⭐	Windows/macOS/Linux/WSL 全覆盖
架构	⭐⭐⭐⭐⭐	x86_64/aarch64/ppc64le/Apple Silicon
CI 友好	⭐⭐⭐⭐⭐	一行静默安装，自动化首选
社区	⭐⭐⭐⭐⭐	conda-forge 3000+ 贡献者
商业友好	⭐⭐⭐⭐⭐	BSD 3-Clause + conda-forge 无商业限制

⚠️ 注意事项

事项	说明
Windows 路径	安装路径避免特殊字符和空格
conda init	Windows 默认只在 Miniforge Prompt 可用，需 init 其他终端
Homebrew	不推荐通过 Homebrew 安装 Miniforge，有兼容性问题
base 环境	建议关闭自动激活，用独立环境管理项目
旧版本	macOS 10.9 / glibc 2.12 需要特定旧版本

💡 使用建议

新手首选 Miniforge：比 Anaconda 更轻量，比 Miniconda 更纯净
关闭 auto_activate_base ：conda config --set auto_activate_base false
复杂环境用 mamba ：mamba install 秒级解析，conda install 备用
环境文件管理 ：每个项目一个 environment.yml，可复现
CI 用 mamba ：setup-miniconda action + use-mamba: true
别用 Homebrew 装：直接下载 SH/EXE/PKG 安装器
旧 Mambaforge 赶紧迁移：已永久不可用

12. 总结

Miniforge 是 Python 环境管理的最佳起点：

🔥 极简纯净：只装 conda + mamba，默认只有 conda-forge 频道
🚀 双引擎：conda 经典兼容 + mamba 极速解析
📱 全平台全架构：6 大架构 × 3 大操作系统 × WSL
🛠️ CI/CD 友好：一行静默安装，GitHub Actions / Docker 无缝集成
🍎 macOS PKG：2026 年新增签名公证 PKG 安装包
🔒 商业友好：BSD 3-Clause + conda-forge 无商业限制
📦 生态最强：conda-forge 25万+ 包，社区驱动更新最快
🔄 Mambaforge 退役：Miniforge3 是唯一的官方推荐

推荐指数：⭐⭐⭐⭐⭐

无论你是 Python 初学者还是资深开发者，无论你在本地开发还是 CI/CD 流水线，Miniforge 都是目前搭建 Python 环境的最佳选择。告别 Anaconda 的臃肿，告别频道冲突的烦恼，一行命令装完即用------Python 环境管理就该这么简单。

📢 项目地址：https://github.com/conda-forge/miniforge

📖 conda-forge：https://conda-forge.org/

标签：#conda-forge #Miniforge #conda #mamba #Python环境管理 #数据科学 #包管理器