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 不匹配”“解压数据截断” 问题）：

1. 获取官方校验和：
   回到 Miniconda 官方下载页，找到对应安装包下方的 MD5 或 SHA256 校验和（如 64a772871649c09648f4d408e9db10ea），复制备用。
2. 计算本地文件校验和：
   终端进入安装包所在目录，执行以下命令（替换为你的文件名）：

   # 验证 MD5 校验和
   md5sum Miniconda3-latest-Linux-x86_64.sh
   # 或验证 SHA256 校验和（更安全）
   sha256sum Miniconda3-latest-Linux-x86_64.sh
   

3. 比对结果：
   终端输出的校验和需与官方完全一致，若不一致，必须重新下载（文件已损坏，强行安装会报错）。

3. 执行安装脚本

1. 赋予脚本执行权限：
   终端中执行（替换为你的文件名），为 .sh 脚本添加可执行权限：

   chmod +x Miniconda3-latest-Linux-x86_64.sh
   

2. 运行安装向导：
   执行脚本启动安装，按提示操作：

   ./Miniconda3-latest-Linux-x86_64.sh
   

   第一步：按 Enter 查看许可协议，按 空格 翻页至末尾，输入 yes 接受协议。
   • 第二步：选择安装路径（默认 ~/miniconda3，直接按 Enter 确认即可；若需自定义，输入路径后回车，确保路径所在磁盘有足够空间）。
   • 第三步：询问 “是否初始化 Miniconda（conda init）”，建议输入 yes（自动配置环境变量，避免后续手动配置的麻烦）。

4. 配置环境变量并验证安装

1. 生效环境变量：
   安装完成后，关闭当前终端并重新打开（或执行以下命令手动生效配置）：

   source ~/.bashrc  # 若使用 zsh 终端，替换为 source ~/.zshrc
   

2. 验证安装成功：
   终端执行以下命令，若输出 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 修复权限。