Ubuntu系统安装Miniconda全过程及注意事项说明
Miniconda是Anaconda的轻量级版本,仅包含Conda包管理器、Python基础环境以及少量必要的依赖库,适合需要灵活管理Python环境、减少冗余组件占用的开发者使用。本文详细介绍在Ubuntu系统中安装Miniconda的完整步骤,以及安装前后的注意事项,帮助读者顺利完成环境配置。
一、安装前准备
在开始安装前,需要确认系统环境满足基本要求,避免安装过程中出现兼容性问题。
确保Ubuntu系统版本为18.04及以上,旧版本系统可能存在依赖库缺失问题。
确认系统已安装
wget或curl工具,用于下载Miniconda安装脚本,若未安装可通过以下命令安装:sudo apt update sudo apt install wget -y
预留至少5GB的磁盘空间,用于存放Miniconda安装文件及后续创建的环境、安装的包。
确认当前用户拥有对应安装目录的读写权限,若选择全局安装建议提前获取sudo权限。
二、下载Miniconda安装脚本
Miniconda官方会定期更新安装脚本,建议下载对应系统架构的最新稳定版本,避免旧版本存在的已知问题。
首先打开终端,执行以下命令下载适配Linux 64位系统的Miniconda安装脚本:
wget https://www.ipipp.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
下载完成后,可通过ls命令查看当前目录是否出现名为Miniconda3-latest-Linux-x86_64.sh的文件,确认下载成功。
三、执行安装脚本
下载完成后,需要给安装脚本添加执行权限,再运行脚本完成安装。
添加执行权限:
chmod +x Miniconda3-latest-Linux-x86_64.sh
运行安装脚本:
bash Miniconda3-latest-Linux-x86_64.sh
阅读许可协议:脚本运行后会显示许可协议内容,按
Enter键逐行浏览,或直接按q键退出浏览,之后输入yes同意协议。选择安装路径:默认安装路径为当前用户的家目录下的
miniconda3文件夹,若需要自定义路径,可输入目标路径后按Enter,建议普通用户使用默认路径,避免权限问题。确认是否初始化Conda:安装完成后脚本会询问是否将Conda初始化到shell配置文件中,输入
yes可以让终端启动后自动激活base环境,输入no则需要手动激活。
四、验证安装结果
安装完成后,需要验证Miniconda是否成功安装并可以正常使用。
若安装时选择了初始化Conda,关闭当前终端并重新打开,终端提示符前会出现
(base)标识,说明base环境已自动激活。执行以下命令查看Conda版本,确认安装成功:
conda --version
若输出类似
conda 23.11.0的版本信息,说明Conda已正确安装。可执行以下命令查看当前已有的环境:
conda env list
默认会显示base环境,对应路径为安装时选择的路径。
五、常用基础操作
安装完成后,可通过以下常用命令管理Miniconda环境与包:
| 操作场景 | 命令示例 | 说明 |
|---|---|---|
| 创建新环境 | conda create -n myenv python=3.9 | 创建名为myenv、Python版本为3.9的新环境 |
| 激活环境 | conda activate myenv | 切换到myenv环境,终端提示符会显示对应环境名 |
| 退出当前环境 | conda deactivate | 退出当前激活的环境,回到上一级环境 |
| 安装包到当前环境 | conda install numpy | 在当前激活的环境中安装numpy包 |
| 删除指定环境 | conda remove -n myenv --all | 删除名为myenv的环境及其中所有安装的包 |
六、注意事项
在安装和使用Miniconda过程中,需要注意以下问题,避免出现异常:
若安装时未选择初始化Conda,每次打开终端需要手动执行
source ~/miniconda3/bin/activate(路径根据安装位置调整)激活base环境,再执行其他Conda操作。不要随意删除Miniconda安装目录下的文件,尤其是
envs文件夹和pkgs文件夹,前者存放所有自定义环境,后者存放下载的包缓存,误删可能导致环境损坏。若遇到Conda命令找不到的问题,检查shell配置文件(如
~/.bashrc或~/.zshrc)中是否包含Conda的初始化语句,若没有可手动添加以下内容后执行source ~/.bashrc生效:# >>> conda initialize >>> # !! Contents within this block are managed by 'conda init' !! __conda_setup="$('/home/your_username/miniconda3/bin/conda' 'shell.bash' 'hook' 2> /dev/null)" if [ $? -eq 0 ]; then eval "$__conda_setup" else if [ -f "/home/your_username/miniconda3/etc/profile.d/conda.sh" ]; then . "/home/your_username/miniconda3/etc/profile.d/conda.sh" else export PATH="/home/your_username/miniconda3/bin:$PATH" fi fi unset __conda_setup # <<< conda initialize <<<注意将路径中的
your_username替换为实际用户名,路径替换为实际安装路径。若不需要终端启动自动激活base环境,可执行以下命令关闭自动激活:
conda config --set auto_activate_base false
若需要重新开启,将
false改为true即可。下载安装脚本时若网络较慢,可替换为国内镜像源地址,示例地址为https://www.ipipp.com/miniconda/Miniconda3-latest-Linux-x86_64.sh,下载完成后校验文件完整性可避免安装失败。