Linux安装Miniconda

158 阅读5分钟

前言

Miniconda是Anaconda的轻量级版本,只包含conda、Python及其依赖包,而不包含大量的科学计算包。它是一个免费开源的包管理器和环境管理器,主要用于Python项目的环境隔离和包管理。相比完整的Anaconda,Miniconda更适合对环境有精确控制需求的开发者。

本文档将详细介绍如何在Linux Ubuntu系统上安装Miniconda,并提供完整的使用指南。


系统要求

支持的Ubuntu版本

  • Ubuntu 18.04 LTS(Bionic Beaver)
  • Ubuntu 20.04 LTS(Focal Fossa)
  • Ubuntu 22.04 LTS(Jammy Jellyfish)
  • Ubuntu 24.04 LTS(Noble Numbat)
  • 以及其他基于Debian的Linux发行版

硬件要求

  • 内存: 至少1GB RAM(推荐2GB或以上)
  • 存储空间: 至少3GB可用磁盘空间
  • 网络: 需要互联网连接以下载安装包和依赖

软件要求

  • 系统已安装基本的命令行工具(wget/curl)
  • 具有sudo权限(用于系统级安装)
  • Bash shell环境

下载Miniconda安装包

方法一:通过官方网站下载

  1. 访问Miniconda官网 Miniconda官网

    https://docs.conda.io/en/latest/miniconda.html
    
  2. 选择适合的版本

    • 对于x86_64架构的系统:Miniconda3-latest-Linux-x86_64.sh
    • 对于ARM架构的系统:Miniconda3-latest-Linux-aarch64.sh
    • 对于PowerPC架构:Miniconda3-latest-Linux-ppc64le.sh
  3. 使用wget下载(推荐)

    # x86_64架构
    wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
    
    # ARM架构
    wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-aarch64.sh
    
  4. 使用curl下载

    # x86_64架构
    curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
    
    # ARM架构
    curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-aarch64.sh
    

方法二:通过命令行快速下载

# 自动检测架构并下载对应版本
ARCH=$(uname -m)
if [ "$ARCH" = "x86_64" ]; then
    wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
elif [ "$ARCH" = "aarch64" ]; then
    wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-aarch64.sh
else
    echo "不支持的架构: $ARCH"
    exit 1
fi

验证下载文件

  1. 检查文件大小(确保下载完整)

    ls -lh Miniconda3-latest-Linux-*.sh
    
  2. 计算SHA256哈希值(可选,用于验证文件完整性)

    sha256sum Miniconda3-latest-Linux-*.sh
    
  3. 查看文件权限

    ls -la Miniconda3-latest-Linux-*.sh
    

安装步骤

  1. 进入下载目录

    cd ~/Downloads  # 或下载文件所在的目录
    
  2. 给安装脚本添加执行权限

    chmod +x Miniconda3-latest-Linux-x86_64.sh
    
  3. 运行安装脚本

    bash Miniconda3-latest-Linux-x86_64.sh
    
  4. 阅读并接受许可协议

    • 按Enter键查看许可协议
    • 输入yes接受协议
    • 按Enter键确认默认安装位置(通常是~/miniconda3
  5. 初始化conda

    • 安装完成后,脚本会询问是否初始化conda
    • 输入yes让conda自动配置shell环境

手动初始化conda(如果自动初始化失败)

# 对于bash shell
~/miniconda3/bin/conda init bash

# 对于zsh shell
~/miniconda3/bin/conda init zsh

# 重新加载shell配置
source ~/.bashrc  # 或 source ~/.zshrc

环境配置和验证

1. 验证安装

  1. 检查conda版本

    conda --version
    
  2. 检查conda信息

    conda info
    
  3. 验证Python版本

    python --version
    python3 --version
    

2. 基本环境配置

  1. 更新conda到最新版本

    conda update conda
    
  2. 配置conda channels(镜像源)

    使用清华镜像源(推荐中国大陆用户):

    conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
    conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
    conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r
    conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/pro
    conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge
    
  3. 设置显示channel URL

    conda config --set show_channel_urls yes
    
  4. 查看当前配置

    conda config --show
    

3. 创建和管理虚拟环境

  1. 创建新的虚拟环境

    # 创建名为myenv的环境,指定Python版本
    conda create -n myenv python=3.9
    
    # 创建环境时安装特定包
    conda create -n myenv python=3.9 numpy pandas matplotlib
    
  2. 激活环境

    conda activate myenv
    
  3. 查看所有环境

    conda env list
    # 或者
    conda info --envs
    
  4. 退出当前环境

    conda deactivate
    
  5. 删除环境

    conda env remove -n myenv
    

常用操作和管理命令

包管理命令

  1. 搜索包

    conda search numpy
    
  2. 安装包

    # 安装最新版本
    conda install numpy
    
    # 安装指定版本
    conda install numpy=1.19.5
    
    # 从特定channel安装
    conda install -c conda-forge numpy
    
    # 安装多个包
    conda install numpy pandas scipy
    
  3. 更新包

    # 更新单个包
    conda update numpy
    
    # 更新所有包
    conda update --all
    
  4. 卸载包

    conda remove numpy
    
  5. 列出已安装的包

    conda list
    
  6. 查看包信息

    conda list numpy
    

环境管理命令

  1. 导出环境

    # 导出当前环境到文件
    conda env export > environment.yml
    
    # 导出指定环境
    conda env export -n myenv > myenv.yml
    
  2. 从文件创建环境

    conda env create -f environment.yml
    
  3. 克隆环境

    conda create --name newenv --clone oldenv
    

配置管理

  1. 查看配置

    conda config --show
    
  2. 添加channel

    conda config --add channels <channel_url>
    
  3. 移除channel

    conda config --remove channels <channel_url>
    
  4. 清理缓存

    conda clean --all
    

常见问题解答

Q1: 安装后conda命令不存在

问题: 输入conda命令提示"command not found"

解决方案:

  1. 确认安装过程中是否初始化了conda
  2. 手动初始化:~/miniconda3/bin/conda init bash
  3. 重新加载shell:source ~/.bashrc
  4. 检查PATH环境变量是否包含conda路径

Q2: 下载速度慢

问题: 从官方源下载包速度很慢

解决方案:

  1. 配置国内镜像源(如清华、阿里云镜像)
  2. 使用代理
  3. .condarc文件中配置镜像源

示例配置文件 (~/.condarc):

channels:
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge
  - defaults
show_channel_urls: true

Q3: 权限问题

问题: 安装或使用时出现权限错误

解决方案:

  1. 确保对安装目录有写权限
  2. 如果是系统级安装,使用sudo
  3. 建议用户级安装,避免权限问题

Q4: 环境激活失败

问题: 无法激活conda环境

解决方案:

  1. 检查conda是否正确初始化
  2. 重新启动终端
  3. 手动激活:source ~/miniconda3/bin/activate

Q5: 包冲突

问题: 安装包时出现依赖冲突

解决方案:

  1. 使用conda update --all更新所有包
  2. 创建新的干净环境
  3. 使用pip安装conda无法解决的包
  4. 指定更具体的包版本

Q6: 卸载Miniconda

需要完全卸载Miniconda时的步骤:

  1. 删除安装目录

    rm -rf ~/miniconda3
    
  2. 清理配置文件

    # 编辑~/.bashrc,删除conda相关行
    vim ~/.bashrc
    
    # 删除.condarc配置文件
    rm ~/.condarc
    
  3. 清理缓存

    rm -rf ~/.conda
    

conda命令使用

一般情况下,安装完成后,直接使用pip命令安装包