Ubuntu系统安装Miniconda全过程及注意事项说明

一、完整安装步骤

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 修复权限。

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。