还在用 Anaconda?Miniforge:conda-forge 官方极简安装器,内置 Mamba,6 大架构全覆盖,5 分钟从零搭建 Python 环境
还在用 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 是什么?
- 2. 为什么选 Miniforge 而不是 Anaconda / Miniconda?
- 3. 安装指南:三大平台全覆盖
- 4. 安装后必做 3 件事
- 5. conda vs mamba:双引擎对比
- 6. 环境管理实战
- 7. CI/CD 集成最佳实践
- 8. 完整平台与架构矩阵
- 9. 卸载与清理
- 10. Mambaforge 退役说明
- 11. 优缺点与使用建议
- 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
# 下载安装器# 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
# 一行下载(自动识别架构)curl-L-O"https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname-m).sh"# 交互式安装bashMiniforge3-$(uname)-$(uname-m).sh# 静默安装(CI/自动化)bashMiniforge3-$(uname)-$(uname-m).sh-b# 安装后初始化~/miniforge3/bin/conda init💡 WSL 用户:确保在 Linux 终端(非 PowerShell)中执行 Linux 安装器!
macOS
# 方式 1:SH 安装器(推荐,支持自动化)curl-L-O"https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-MacOSX-$(uname-m).sh"bashMiniforge3-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
# 初始化 conda(让 conda/mamba 在任意终端可用)conda init# 如果用的是 zshconda initzsh# 如果用的是 fishconda init fish第 2 步:关闭自动激活 base
# 关闭 base 环境自动激活(推荐!避免污染系统 Python)conda config--setauto_activate_basefalse# 需要时手动激活conda activate第 3 步:验证安装
# 检查 condaconda--version# 输出示例:conda 25.x.x# 检查 mambamamba--version# 输出示例:mamba 2.x.x# 检查频道配置conda config--showchannels# 应该只有:conda-forge5. 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. 环境管理实战
创建新环境
# 基础创建conda create-nmy_projectpython=3.12# 创建时直接装包(推荐!一次解析所有依赖)conda create-ndata_sciencepython=3.12jupyterlab numpy pandas matplotlib scikit-learn# 用 mamba 创建(更快)mamba create-nml_projectpython=3.12pytorch torchvision torchaudio# 从 YAML 文件创建condaenvcreate-fenvironment.yml激活 / 退出环境
# 激活conda activate my_project# 退出conda deactivate# 查看所有环境condaenvlist安装包
# conda 安装condainstallnumpy pandas# mamba 安装(推荐复杂场景)mambainstallpytorch torchvision-cpytorch# pip 安装(conda 找不到的包)pipinstallsome-package导出 / 复现环境
# 导出环境condaenvexport>environment.yml# 从导出文件创建condaenvcreate-fenvironment.yml# 克隆环境conda create--namemy_clone--clonemy_project典型环境模板
# environment.yml - 数据科学项目name:data_sciencechannels:-conda-forgedependencies:-python=3.12-jupyterlab-numpy-pandas-matplotlib-scikit-learn-seaborn-pip:-kaggle# environment.yml - PyTorch 深度学习项目name:pytorch_projectchannels:-conda-forgedependencies:-python=3.12-pytorch-torchvision-torchaudio-cuda-version=12.4-pip:-transformers-datasets-accelerate7. CI/CD 集成最佳实践
GitHub Actions
# .github/workflows/test.ymlname:Teston:[push,pull_request]jobs:test:runs-on:ubuntu-lateststeps:-uses:actions/checkout@v4-name:Setup Miniforgeuses:conda-incubator/setup-miniconda@v3with:miniforge-version:latestuse-mamba:trueactivate-environment:testenvironment-file:environment.yml-name:Run testsshell:bash-l{0}run:|python -m pytest手动 CI 安装
# Linux CIwget-OMiniforge3.sh"https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname-m).sh"bashMiniforge3.sh-b-p"${HOME}/conda"source"${HOME}/conda/etc/profile.d/conda.sh"source"${HOME}/conda/etc/profile.d/mamba.sh"conda activate# macOS CIcurl-fsSLoMiniforge3.sh"https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-MacOSX-$(uname-m).sh"bashMiniforge3.sh-b-p"${HOME}/conda"source"${HOME}/conda/etc/profile.d/conda.sh"conda activateDocker 集成
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. 卸载与清理
完整卸载三步走
# 步骤 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-minicondaaction +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环境管理 #数据科学 #包管理器
