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

     

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

相关文章