前言
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安装包
方法一:通过官方网站下载
-
访问Miniconda官网 Miniconda官网
https://docs.conda.io/en/latest/miniconda.html -
选择适合的版本
- 对于x86_64架构的系统:
Miniconda3-latest-Linux-x86_64.sh - 对于ARM架构的系统:
Miniconda3-latest-Linux-aarch64.sh - 对于PowerPC架构:
Miniconda3-latest-Linux-ppc64le.sh
- 对于x86_64架构的系统:
-
使用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 -
使用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
验证下载文件
-
检查文件大小(确保下载完整)
ls -lh Miniconda3-latest-Linux-*.sh -
计算SHA256哈希值(可选,用于验证文件完整性)
sha256sum Miniconda3-latest-Linux-*.sh -
查看文件权限
ls -la Miniconda3-latest-Linux-*.sh
安装步骤
-
进入下载目录
cd ~/Downloads # 或下载文件所在的目录 -
给安装脚本添加执行权限
chmod +x Miniconda3-latest-Linux-x86_64.sh -
运行安装脚本
bash Miniconda3-latest-Linux-x86_64.sh -
阅读并接受许可协议
- 按Enter键查看许可协议
- 输入
yes接受协议 - 按Enter键确认默认安装位置(通常是
~/miniconda3)
-
初始化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. 验证安装
-
检查conda版本
conda --version -
检查conda信息
conda info -
验证Python版本
python --version python3 --version
2. 基本环境配置
-
更新conda到最新版本
conda update conda -
配置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 -
设置显示channel URL
conda config --set show_channel_urls yes -
查看当前配置
conda config --show
3. 创建和管理虚拟环境
-
创建新的虚拟环境
# 创建名为myenv的环境,指定Python版本 conda create -n myenv python=3.9 # 创建环境时安装特定包 conda create -n myenv python=3.9 numpy pandas matplotlib -
激活环境
conda activate myenv -
查看所有环境
conda env list # 或者 conda info --envs -
退出当前环境
conda deactivate -
删除环境
conda env remove -n myenv
常用操作和管理命令
包管理命令
-
搜索包
conda search numpy -
安装包
# 安装最新版本 conda install numpy # 安装指定版本 conda install numpy=1.19.5 # 从特定channel安装 conda install -c conda-forge numpy # 安装多个包 conda install numpy pandas scipy -
更新包
# 更新单个包 conda update numpy # 更新所有包 conda update --all -
卸载包
conda remove numpy -
列出已安装的包
conda list -
查看包信息
conda list numpy
环境管理命令
-
导出环境
# 导出当前环境到文件 conda env export > environment.yml # 导出指定环境 conda env export -n myenv > myenv.yml -
从文件创建环境
conda env create -f environment.yml -
克隆环境
conda create --name newenv --clone oldenv
配置管理
-
查看配置
conda config --show -
添加channel
conda config --add channels <channel_url> -
移除channel
conda config --remove channels <channel_url> -
清理缓存
conda clean --all
常见问题解答
Q1: 安装后conda命令不存在
问题: 输入conda命令提示"command not found"
解决方案:
- 确认安装过程中是否初始化了conda
- 手动初始化:
~/miniconda3/bin/conda init bash - 重新加载shell:
source ~/.bashrc - 检查PATH环境变量是否包含conda路径
Q2: 下载速度慢
问题: 从官方源下载包速度很慢
解决方案:
- 配置国内镜像源(如清华、阿里云镜像)
- 使用代理
- 在
.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: 权限问题
问题: 安装或使用时出现权限错误
解决方案:
- 确保对安装目录有写权限
- 如果是系统级安装,使用sudo
- 建议用户级安装,避免权限问题
Q4: 环境激活失败
问题: 无法激活conda环境
解决方案:
- 检查conda是否正确初始化
- 重新启动终端
- 手动激活:
source ~/miniconda3/bin/activate
Q5: 包冲突
问题: 安装包时出现依赖冲突
解决方案:
- 使用
conda update --all更新所有包 - 创建新的干净环境
- 使用pip安装conda无法解决的包
- 指定更具体的包版本
Q6: 卸载Miniconda
需要完全卸载Miniconda时的步骤:
-
删除安装目录
rm -rf ~/miniconda3 -
清理配置文件
# 编辑~/.bashrc,删除conda相关行 vim ~/.bashrc # 删除.condarc配置文件 rm ~/.condarc -
清理缓存
rm -rf ~/.conda
conda命令使用
一般情况下,安装完成后,直接使用pip命令安装包