Miniforge 安装与使用指南（下载、选择、校验、安装与基础使用）
文章目录
如果你对 pip / venv / uv / conda 以及 Anaconda/Miniconda/Miniforge/conda-forge/mamba 这些概念的区别还不熟悉，建议先阅读这篇讲解，再继续本文的安装步骤：
Python 环境与依赖管理讲解：pip、venv、uv、conda，以及 Anaconda/Miniconda/Miniforge/conda-forge/mamba
本文以 Miniforge（conda-forge 社区维护的 conda 安装器）为对象，整理：
- 去哪里下载与如何选择安装包
- 如何校验安装包完整性（sha256）
- Windows/macOS/Linux 的安装与初始化步骤
- PowerShell 下让 conda 可用的初始化步骤（含常见卡点与处理）
下载入口参考：conda-forge/miniforge Releases
先说明两个名词：conda-forge 是什么？为什么 Miniforge 默认用它？
在 conda 生态里，“软件源”通常以 channel 的形式出现。可以把 channel 理解为“包从哪里下载”的仓库。
conda-forge：一个由开源社区维护的超大 channel，特点通常是包多、更新快、覆盖广（尤其在科学计算/深度学习相关库上）。defaults：Anaconda（公司）维护的一组默认 channel（常见地址是repo.anaconda.com/pkgs/...），兼容性策略相对保守，但在商业使用上需要关注条款。
Miniforge 的定位是“社区版的精简 conda 安装器”，它之所以默认指向 conda-forge，主要是为了：
- 让安装后默认就能从社区源获取更丰富的包；
- 避免默认落到
defaults的条款/合规不确定性（组织环境尤其敏感）。
需要强调：这只是“默认配置”。无论你用 Miniforge、Miniconda 还是 Anaconda Distribution，conda 都可以通过 -c ... 或配置文件调整使用的 channel；关键在于一个环境内尽量保持 channel 策略一致。
1. 下载：去哪里下
Miniforge 的官方发布页面在 GitHub Releases：
在某个 Release（例如 26.5.3-0）的 Assets 区域里，会看到不同操作系统与架构的安装包，以及对应的 *.sha256 校验文件。
2. 选择：下载哪个文件
1）先按操作系统/架构选对安装包
- Windows x86_64（绝大多数 Intel/AMD 电脑）：
Miniforge3-<版本>-Windows-x86_64.exe - macOS Apple Silicon（M1/M2/M3…）：
Miniforge3-<版本>-MacOSX-arm64.pkg（或.sh） - macOS Intel：
Miniforge3-<版本>-MacOSX-x86_64.pkg（或.sh） - Linux x86_64：
Miniforge3-<版本>-Linux-x86_64.sh - Linux arm64（aarch64）：
Miniforge3-<版本>-Linux-aarch64.sh
说明：
.exe：Windows 图形安装器（推荐）.pkg：macOS 安装包（推荐）.sh：shell 安装脚本（Linux/macOS 可用；适合服务器/脚本化安装）
2）带版本号 vs 不带版本号：有什么区别
Assets 中通常会同时出现两种命名风格（以 Windows 为例）：
Miniforge3-26.5.3-0-Windows-x86_64.exe（带版本号）Miniforge3-Windows-x86_64.exe（不带版本号，固定名称）
二者通常是同一个安装器的“不同文件名”，可通过页面上的 sha256 是否一致来确认。常见选择建议：
- 需要可复现（团队/文档/CI 希望固定版本）：优先选 带版本号
- 只想永远下载最新版：选 不带版本号（方便脚本/链接）
3）*.sha256 文件是什么
例如：
Miniforge3-26.5.3-0-Windows-x86_64.exe.sha256
这是一个很小的文本文件，里面存放对应安装包的 sha256 值，用于下载后校验文件是否损坏或被篡改。它本身不是安装器，不能运行。
3. 校验（可选但推荐）：验证 sha256
Windows（PowerShell）
Get-FileHash "D:\SoftwarePackage\Miniforge3-26.5.3-0-Windows-x86_64.exe" -Algorithm SHA256
把输出的哈希值与 Release 页面上列出的 sha256 对比即可。
Linux
sha256sum Miniforge3-26.5.3-0-Linux-x86_64.sh
macOS
shasum -a 256 Miniforge3-26.5.3-0-MacOSX-arm64.pkg
4. 安装（Windows）：安装器选项如何勾选
Windows .exe 安装器一般会有几个关键选项（名称可能略有差异）：
- Create shortcuts：创建快捷方式（建议勾选）
- Add installation to PATH：加入系统 PATH（通常不建议勾选，避免与系统 Python/其他工具冲突）
- Register as default Python：注册为系统默认 Python（通常不建议勾选，除非你明确希望系统默认 Python 指向 Miniforge）
- Clear package cache upon completion：安装后清理包缓存（可选，勾选可节省空间）
客观实践建议（更少冲突）：
- 不把 Miniforge 加到全局 PATH
- 不注册为系统默认 Python
- 通过
conda init让 shell 正确加载 conda
5. 初始化：让 conda 在 PowerShell 中可用（含常见卡点）
Miniforge 安装完成后，若希望在 PowerShell（包括 Cursor/VSCode 内置终端）直接使用 conda，通常需要完成一次 shell 初始化。但在开始配置前，建议先做一个最短的判断：你当前的 PowerShell 是否已经识别 conda。
快速检查
在你“实际要用 conda 的那个 PowerShell”（例如系统 PowerShell、或 Cursor/VSCode 内置终端的 PowerShell）里执行：
conda --version
- 如果能正常输出版本号：说明该 PowerShell 已能使用 conda，可跳过本节后面的初始化与执行策略说明，直接继续下一节的“推荐配置”。
- 如果提示
conda : 无法将“conda”项识别为 ...：通常意味着“conda 未注入到当前 shell（未 init）或 profile 未能执行”，继续按本节步骤处理即可。
重要前提：
conda init ...需要当前终端里已经能执行conda命令。- 如果你在“普通 PowerShell”里输入
conda显示“无法识别”，推荐先从开始菜单打开 Miniforge Prompt（或 Miniforge/Conda Prompt 这类入口），在该终端里执行conda init powershell，再回到普通 PowerShell/IDE 终端验证。
Windows/PowerShell 额外提示：
conda init powershell的实现方式通常是：把 conda 初始化代码写入 PowerShell profile（profile.ps1），让它在每次启动 PowerShell 时自动加载。- 如果你的 PowerShell 执行策略（ExecutionPolicy）禁止运行脚本，profile 可能无法加载，表现为启动时出现
PSSecurityException/“禁止运行脚本”，并导致conda在普通 PowerShell 或 IDE 终端里不可用。 - 这种情况下，建议先确认策略，再按需调整（仅影响当前用户）：
Get-ExecutionPolicy -List
若 CurrentUser 显示为 Restricted（或你已经遇到 profile 被阻止的报错），常见折中做法是：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
这条设置的含义：
- 它改变的是“脚本执行策略”，目的是让 PowerShell 能加载/执行你的
profile.ps1（conda init 写入的初始化代码也在这里）。 -Scope CurrentUser：只对当前 Windows 用户生效，不影响整台机器的全局设置与其他用户账户。RemoteSigned的具体行为（概念上）：- 本机创建/本机保存的
.ps1脚本：通常允许运行 - 来自互联网并带“来源标记”（Mark-of-the-Web）的脚本：通常需要签名才允许运行（未签名会被阻止/提示）
- 本机创建/本机保存的
- 潜在影响：相较于
Restricted，你在当前用户下运行本地脚本的门槛降低了。因此安全实践通常包括“不运行来源不明的.ps1脚本”“对下载脚本保持警惕”等。 - 如何回退（如果后续不需要/不希望放宽策略）：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Restricted
调整后需要关闭并重新打开 PowerShell/IDE，再继续后续步骤。
conda init powershell
执行完成后需要：
- 关闭当前 PowerShell 窗口
- 重启终端（在 IDE 场景建议重启 Cursor/VSCode）
验证：
conda --version
说明：
conda init powershell通常会修改用户的 PowerShell profile（常见路径：C:\Users\<用户名>\Documents\WindowsPowerShell\profile.ps1），使 conda 的 hook 在每次启动 PowerShell 时自动加载。- 输出中出现
modified ... profile.ps1通常表示写入成功；出现大量no change也属于正常情况（表示文件内容无需改动）。
6. 推荐配置：避免 base 自动激活与更稳定的 channel 行为
1）避免每次打开终端都自动进入 (base)
conda config --set auto_activate false
2）启用 strict channel priority（减少混源导致的求解异常）
conda config --set channel_priority strict
3）检查当前默认软件源（channel）与优先级（建议确认一次）
conda config --show channels
conda config --show channel_priority
conda config --show default_channels
输出的含义（示例解释）：
channels: - conda-forge：表示当前配置里 首选的软件源是conda-forge。channel_priority: strict：表示启用了严格优先级，通常会尽量避免“混源拼装”依赖。default_channels: https://repo.anaconda.com/pkgs/...：表示defaults这组默认渠道（Anaconda 仓库地址）仍在配置中；当conda-forge找不到某些包时，conda 会考虑它们。
7. 基本用法：创建环境、激活、安装、退出
先说明一个常见疑问：是否需要每次都写 -c conda-forge？
- 如果你已经把
conda-forge配成默认首选 channel（conda config --show channels的第一项是conda-forge），本节的命令可以不写-c conda-forge。 - Anaconda Distribution / Miniconda 的默认软件源通常是
defaults；因此当你写给这类用户照抄的命令时，显式写-c conda-forge更直观，也能减少歧义。 - 什么时候“显式使用
-c conda-forge”比较常见：默认源找不到包、或需要 conda-forge 上更新更快/覆盖更全的构建时。 - 更重要的是：同一个环境里尽量保持 channel 策略一致。如果只是“某个包找不到就临时换源补一个”，虽然可能装上，但更容易积累求解冲突与二进制不兼容问题（尤其在科学计算/深度学习的二进制栈里）。
创建一个新环境（示例：Python 3.12）
# 写法 A：默认首选 channel 已是 conda-forge（Miniforge 常见配置）
conda create -n test python=3.12
# 写法 B：显式指定从 conda-forge 创建（默认源不确定时更直观）
conda create -n test python=3.12 -c conda-forge
激活环境
conda activate test
安装包（示例）
# 写法 A：默认首选 channel 已是 conda-forge
conda install numpy pandas
# 写法 B：显式指定从 conda-forge 安装（默认源不确定时更直观）
conda install -c conda-forge numpy pandas
退出环境
conda deactivate
openEuler 是由开放原子开源基金会孵化的全场景开源操作系统项目，面向数字基础设施四大核心场景（服务器、云计算、边缘计算、嵌入式），全面支持 ARM、x86、RISC-V、loongArch、PowerPC、SW-64 等多样性计算架构
更多推荐
3
0- 0
已为社区贡献1条内容
所有评论(0)