一、完整安装步骤
1. 下载 miniconda 安装包
miniconda 安装包为 .sh 格式脚本,下载途径分两种:
方式 1:浏览器下载(适合新手)
访问 miniconda 官方下载页,选择对应系统版本(ubuntu 选 miniconda3-latest-linux-x86_64.sh),默认保存到用户目录的 ~/downloads 文件夹。
若找不到文件,可通过终端进入下载目录查看:
cd ~/downloads && ls | grep miniconda
方式 2:命令行下载(高效)
直接在终端执行 wget 或 curl 命令(需确保网络稳定),文件会保存到当前执行命令的目录(建议先进入目标目录,如 ~/):
# 下载最新版 miniconda3(64位) wget https://repo.anaconda.com/miniconda/miniconda3-latest-linux-x86_64.sh
若忘记下载路径,可通过 find 命令全局搜索:
find ~ -name "miniconda3-*.sh" # 搜索用户目录下所有 miniconda 安装包
2. 验证安装包完整性(关键!避免安装失败)
下载后必须校验文件是否完整(防止网络中断导致文件损坏,之前出现过 “md5sum 不匹配”“解压数据截断” 问题):
获取官方校验和:
回到 miniconda 官方下载页,找到对应安装包下方的 md5 或 sha256 校验和(如 64a772871649c09648f4d408e9db10ea),复制备用。
计算本地文件校验和:
终端进入安装包所在目录,执行以下命令(替换为你的文件名):
# 验证 md5 校验和 md5sum miniconda3-latest-linux-x86_64.sh # 或验证 sha256 校验和(更安全) sha256sum miniconda3-latest-linux-x86_64.sh
比对结果:
终端输出的校验和需与官方完全一致,若不一致,必须重新下载(文件已损坏,强行安装会报错)。
3. 执行安装脚本
赋予脚本执行权限:
终端中执行(替换为你的文件名),为 .sh 脚本添加可执行权限:
chmod +x miniconda3-latest-linux-x86_64.sh
运行安装向导:
执行脚本启动安装,按提示操作:
./miniconda3-latest-linux-x86_64.sh
- 第一步:按
enter查看许可协议,按空格翻页至末尾,输入yes接受协议。 - 第二步:选择安装路径(默认
~/miniconda3,直接按enter确认即可;若需自定义,输入路径后回车,确保路径所在磁盘有足够空间)。 - 第三步:询问 “是否初始化 miniconda(conda init)”,建议输入 yes(自动配置环境变量,避免后续手动配置的麻烦)。
4. 配置环境变量并验证安装
生效环境变量:
安装完成后,关闭当前终端并重新打开(或执行以下命令手动生效配置):
source ~/.bashrc # 若使用 zsh 终端,替换为 source ~/.zshrc
验证安装成功:
终端执行以下命令,若输出 conda x.x.x 版本号,说明安装成功:
conda --version
二、关键注意事项
1. 安装前必做:校验文件完整性
这是避免 “解压失败”“md5sum 不匹配” 的核心步骤!若跳过此步,文件损坏会导致安装到一半报错(如 tarfile.readerror: unexpected end of data),需重新下载。
2. 安装路径选择
- 不建议安装到
/root目录(避免权限问题,普通用户无法正常使用),默认~/miniconda3是最佳选择(仅当前用户可访问,避免多用户冲突)。 - 若需多用户共享,可安装到
/opt/miniconda3,但需管理员权限(sudo ./xxx.sh),且后续使用需注意权限分配。
3. 初始化选项(conda init)的重要性
若安装时误选 no,将无法直接在终端使用 conda 命令,需手动配置环境变量:
# 编辑 .bashrc 文件,添加 miniconda 路径 echo 'export path="~/miniconda3/bin:$path"' >> ~/.bashrc # 生效配置 source ~/.bashrc
4. 清理旧版本残留
若之前安装过不完整的 miniconda(如报错后中断),需先删除旧目录再重新安装,避免文件冲突:
rm -rf ~/miniconda3 # 删除默认安装目录,若自定义过路径则替换为对应路径
5. 安装后优化
更新 conda:安装完成后建议立即更新到最新版本,提升稳定性:
conda update -n base -c defaults conda
配置国内镜像源:默认源下载速度较慢,可添加清华 / 中科大镜像(解决 “conda install 卡住” 问题):
# 添加清华镜像 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/main/ conda config --set show_channel_urls yes
6. 避免权限陷阱
不要用 sudo 执行安装脚本(除非确需多用户共享),否则普通用户使用 conda 时可能出现 “权限不足”(如无法创建环境、安装包),需通过 sudo chown -r $user: $home/miniconda3 修复权限。
总结
以上为个人经验,希望能给大家一个参考,也希望大家多多支持代码网。
发表评论