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

时间:2024-10-02 07:48:16

(注:主要是解决商业应用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 为例):
  3. bash Miniforge3-MacOSX-arm64.sh
    
  4. 阅读许可协议并选择 yes
  5. 选择 Miniforge 的安装路径,默认路径通常在用户主目录下的 .miniforge3 文件夹中。

步骤 3:激活 Miniforge 环境

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

source ~/.bashrc  # 或者 ~/.zshrc

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

conda --version
步骤 4:创建和管理 conda 环境

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

conda create -n newEnv python=3.9

然后激活环境:

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,输入以下命令来测试安装是否成功:

conda --version

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

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

1. 确保 conda 已安装

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

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

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

2. 手动激活 conda 环境

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

临时激活 conda

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

source ~/miniforge3/bin/activate

 之后尝试运行 conda --version

永久配置 conda 自动激活

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

  1. 打开 .zshrc 文件:

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

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

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

    source ~/.zshrc
    

3. 确认 conda 已被正确安装

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

4. 重新安装 Miniforge

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

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

    rm -rf ~/miniforge3
    

4.安装成功 

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

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

conda config --set auto_activate_base false

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

conda activate base

     

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