Miniforge详细安装教程(macOs和Windows)

(注:主要是解决商业应用anaconda收费问题,这是轻量级的代替,个人完全可以使用anaconda和miniconda)

Miniforge 是一个轻量级的包管理器,类似于 Anaconda 和 Miniconda。它主要用于安装基于 conda 的 Python 环境,专注于兼容 ARM 架构的设备(如 Apple M1/M2 /M3芯片)和其它 CPU 架构。Miniforge 使用 conda-forge 作为默认的包管理渠道。下面是如何在不同系统中安装 Miniforge 的步骤。下面这些是本人安装过程出现的一些问题,及解决办法。

1. 在 macOS 和 Linux 上安装 Miniforge

步骤 1:下载 Miniforge
  1. 访问 Miniforge GitHub 页面https://github.com/conda-forge/miniforge/releases
  2. 根据系统下载相应的安装脚本:
    • macOS (Intel):Miniforge3-MacOSX-x86_64.sh
    • macOS (Apple Silicon/M1/M2):Miniforge3-MacOSX-arm64.sh
    • Linux (x86_64):Miniforge3-Linux-x86_64.sh
    • Linux (ARM):Miniforge3-Linux-aarch64.sh
步骤 2:安装 Miniforge
  1. 打开终端并导航到下载的 .sh 文件所在的目录。
  2. 运行以下命令安装 Miniforge(以 macOS ARM 为例):
bash 复制代码
bash Miniforge3-MacOSX-arm64.sh
  1. 阅读许可协议并选择 yes
  2. 选择 Miniforge 的安装路径,默认路径通常在用户主目录下的 .miniforge3 文件夹中。
步骤 3:激活 Miniforge 环境

安装完成后,终端会提示你执行以下命令来激活 conda 环境:

bash 复制代码
source ~/.bashrc  # 或者 ~/.zshrc

之后可以通过以下命令来检查 conda 是否安装成功:

bash 复制代码
conda --version
步骤 4:创建和管理 conda 环境

你现在可以使用 conda 命令创建新环境,例如创建一个 Python 3.9 环境:

bash 复制代码
conda create -n newEnv python=3.9

然后激活环境:

bash 复制代码
conda activate newEnv

2. 在 Windows 上安装 Miniforge

步骤 1:下载 Miniforge 安装包
  1. 前往 Miniforge GitHub Releaseshttps://github.com/conda-forge/miniforge/releases
  2. 下载适用于 Windows 的安装包:Miniforge3-Windows-x86_64.exe
步骤 2:运行安装程序
  1. 双击下载的 .exe 文件启动安装程序。
  2. 按照安装向导的指引进行安装,选择合适的安装目录。
  3. 在安装完成时勾选"Add Miniforge3 to PATH"选项。
步骤 3:启动 Miniforge

安装完成后,你可以打开 Anaconda Prompt 或者使用 Windows PowerShell,输入以下命令来测试安装是否成功:

bash 复制代码
conda --version

3.安装遇到的问题及解决办法

出现 zsh: command not found: conda 错误,说明 conda 命令没有被正确地添加到你的 PATH 环境变量中,或者 Miniforge 的安装没有成功激活。

1. 确保 conda 已安装

如果你刚安装了 Miniforge,请确保安装过程没有错误。检查 Miniforge 是否正确安装:

  • 打开终端,导航到 Miniforge 安装的目录(默认通常是 ~/.miniforge3 或者 ~/miniforge3)。
  • 在该目录下,检查是否有 conda 二进制文件:bin/conda
bash 复制代码
cd ~/miniforge3/bin
ls

如果 conda 文件存在,说明 Miniforge 已经安装,但未正确配置环境。

2. 手动激活 conda 环境

如果安装了 Miniforge,可能是 conda 没有自动添加到 zsh 的启动配置文件里(如 .zshrc)。你可以手动加载 Miniforge 的初始化脚本:

临时激活 conda

在终端执行以下命令来临时激活 conda:

bash 复制代码
source ~/miniforge3/bin/activate

之后尝试运行 conda --version

永久配置 conda 自动激活

如果上面的命令生效了,你可以把 Miniforge 的路径永久添加到你的 .zshrc 文件中:

  1. 打开 .zshrc 文件:

    bash 复制代码
    nano ~/.zshrc
  2. 在文件末尾添加以下内容,确保 conda 的初始化脚本被加载:

    bash 复制代码
    export PATH="~/miniforge3/bin:$PATH"
  3. 保存文件并退出(按 Ctrl + O 保存,Ctrl + X 退出)。

  4. 重新加载 .zshrc 文件,或者关闭并重新打开终端:

    bash 复制代码
    source ~/.zshrc

3. 确认 conda 已被正确安装

再次检查 conda :conda -V(同conda --version)

4. 重新安装 Miniforge

如果问题依旧存在,可能安装过程中出现了问题,建议重新安装 Miniforge。

  1. 先删除之前的安装目录:

    bash 复制代码
    rm -rf ~/miniforge3

4.安装成功

安装 Miniforge 后,conda 默认会激活它的基础环境(base)。这意味着每次你打开终端时,base 环境会自动激活,导致你看到终端提示符前面的 (base)

如果你不希望每次启动终端时自动激活 base 环境,可以禁用这个行为。你可以通过运行以下命令来关闭自动激活:

bash 复制代码
conda config --set auto_activate_base false

关闭自动激活后,你仍然可以手动激活 base 环境或任何其他虚拟环境,命令如下:

bash 复制代码
conda activate base

这些就是详情的安装教程了!!!希望对你们有帮助

相关推荐
命里有定数32 分钟前
保姆级教程:在 Windows (WSL2) 下本地部署 Qwen3-ASR
windows
普通网友1 小时前
苹果笔记本(Mac)连接手机完全指南
macos·智能手机
Aftery的博客3 小时前
Xcode运行报错:SDK does not contain ‘libarclite‘ at the path
macos·cocoa·xcode
lucky67074 小时前
Windows 上彻底卸载 Node.js
windows·node.js
编程小白20264 小时前
从 C++ 基础到效率翻倍:Qt 开发环境搭建与Windows 神级快捷键指南
开发语言·c++·windows·qt·学习
凯子坚持 c6 小时前
CANN 性能剖析实战:从原始事件到交互式火焰图
windows·microsoft
开开心心就好7 小时前
发票合并打印工具,多页布局设置实时预览
linux·运维·服务器·windows·pdf·harmonyos·1024程序员节
獨枭7 小时前
PyCharm 跑通 SAM 全流程实战
windows
仙剑魔尊重楼7 小时前
音乐制作电子软件FL Studio2025.2.4.5242中文版新功能介绍
windows·音频·录屏·音乐·fl studio
PHP小志8 小时前
Windows 服务器怎么修改密码和用户名?账户被系统锁定如何解锁
windows