Ubuntu系统安装Miniconda全过程及注意事项说明
<div id="navCategory"><h5 class="catalogue">目录</h5><ul class="first_class_ul"><li><a href="#_label0">一、完整安装步骤</a></li><ul class="second_class_ul"><li><a href="#_lab2_0_0">1. 下载 Miniconda 安装包</a></li><li><a href="#_lab2_0_1">2. 验证安装包完整性（关键！避免安装失败）</a></li><li><a href="#_lab2_0_2">3. 执行安装脚本</a></li><li><a href="#_lab2_0_3">4. 配置环境变量并验证安装</a></li></ul><li><a href="#_label1">二、关键注意事项</a></li><ul class="second_class_ul"><li><a href="#_lab2_1_4">1. 安装前必做：校验文件完整性</a></li><li><a href="#_lab2_1_5">2. 安装路径选择</a></li><li><a href="#_lab2_1_6">3. 初始化选项（conda init）的重要性</a></li><li><a href="#_lab2_1_7">4. 清理旧版本残留</a></li><li><a href="#_lab2_1_8">5. 安装后优化</a></li><li><a href="#_lab2_1_9">6. 避免权限陷阱</a></li></ul><li><a href="#_label2">总结</a></li><ul class="second_class_ul"></ul></ul></div><p class="maodian"><a name="_label0"></a></p><h2>一、完整安装步骤</h2><p class="maodian"><a name="_lab2_0_0"></a></p><h3>1. 下载 Miniconda 安装包</h3>
<p>Miniconda 安装包为 <code>.sh</code> 格式脚本，下载途径分两种：</p>
<p><strong>方式 1：浏览器下载（适合新手）</strong></p>
<p>访问 <span><a href="https://repo.anaconda.com/miniconda/" rel="external nofollow"rel="nofollow noopener noreferrer" target="_blank" title="Miniconda 官方下载页">Miniconda 官方下载页</a></span>，选择对应系统版本（Ubuntu 选 <code>Miniconda3-latest-Linux-x86_64.sh</code>），默认保存到用户目录的 <code>~/Downloads</code> 文件夹。</p>
<p>若找不到文件，可通过终端进入下载目录查看：</p>
<div class="jb51code"><pre class="brush:bash;">cd ~/Downloads && ls | grep Miniconda
</pre></div>
<p><strong>方式 2：命令行下载（高效）</strong></p>
<p>直接在终端执行 <code>wget</code> 或 <code>curl</code> 命令（需确保网络稳定），文件会保存到<strong>当前执行命令的目录</strong>（建议先进入目标目录，如 <code>~/</code>）：</p>
<div class="jb51code"><pre class="brush:bash;"># 下载最新版 Miniconda3（64位）
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
</pre></div>
<p>若忘记下载路径，可通过 <code>find</code> 命令全局搜索：</p>
<div class="jb51code"><pre class="brush:bash;">find ~ -name "Miniconda3-*.sh"# 搜索用户目录下所有 Miniconda 安装包
</pre></div>
<p class="maodian"><a name="_lab2_0_1"></a></p><h3>2. 验证安装包完整性（关键！避免安装失败）</h3>
<p>下载后必须校验文件是否完整（防止网络中断导致文件损坏，之前出现过 “md5sum 不匹配”“解压数据截断” 问题）：</p>
<p><strong>获取官方校验和</strong>：</p>
<p>回到 Miniconda 官方下载页，找到对应安装包下方的 <strong>MD5</strong> 或 <strong>SHA256</strong> 校验和（如 <code>64a772871649c09648f4d408e9db10ea</code>），复制备用。</p>
<p><strong>计算本地文件校验和</strong>：</p>
<p>终端进入安装包所在目录，执行以下命令（替换为你的文件名）：</p>
<div class="jb51code"><pre class="brush:bash;"># 验证 MD5 校验和
md5sum Miniconda3-latest-Linux-x86_64.sh
# 或验证 SHA256 校验和（更安全）
sha256sum Miniconda3-latest-Linux-x86_64.sh
</pre></div>
<p><strong>比对结果</strong>：</p>
<p>终端输出的校验和需与官方完全一致，若不一致，<strong>必须重新下载</strong>（文件已损坏，强行安装会报错）。</p>
<p class="maodian"><a name="_lab2_0_2"></a></p><h3>3. 执行安装脚本</h3>
<p><strong>赋予脚本执行权限</strong>：</p>
<p>终端中执行（替换为你的文件名），为 <code>.sh</code> 脚本添加可执行权限：</p>
<div class="jb51code"><pre class="brush:bash;">chmod +x Miniconda3-latest-Linux-x86_64.sh
</pre></div>
<p><strong>运行安装向导</strong>：</p>
<p>执行脚本启动安装，按提示操作：</p>
<div class="jb51code"><pre class="brush:bash;">./Miniconda3-latest-Linux-x86_64.sh
</pre></div>
<ul><li>第一步：按 <code>Enter</code> 查看许可协议，按 <code>空格</code> 翻页至末尾，输入 <code>yes</code> 接受协议。</li><li>第二步：选择安装路径（默认 <code>~/miniconda3</code>，直接按 <code>Enter</code> 确认即可；若需自定义，输入路径后回车，确保路径所在磁盘有足够空间）。</li><li>第三步：询问 “是否初始化 Miniconda（conda init）”，<strong>建议输入 yes</strong>（自动配置环境变量，避免后续手动配置的麻烦）。</li></ul>
<p class="maodian"><a name="_lab2_0_3"></a></p><h3>4. 配置环境变量并验证安装</h3>
<p><strong>生效环境变量</strong>：</p>
<p>安装完成后，关闭当前终端并重新打开（或执行以下命令手动生效配置）：</p>
<div class="jb51code"><pre class="brush:bash;">source ~/.bashrc# 若使用 zsh 终端，替换为 source ~/.zshrc
</pre></div>
<p><strong>验证安装成功</strong>：</p>
<p>终端执行以下命令，若输出 <code>conda x.x.x</code> 版本号，说明安装成功：</p>
<div class="jb51code"><pre class="brush:bash;">conda --version
</pre></div>
<p class="maodian"><a name="_label1"></a></p><h2>二、关键注意事项</h2>
<p class="maodian"><a name="_lab2_1_4"></a></p><h3>1. 安装前必做：校验文件完整性</h3>
<p>这是避免 “解压失败”“md5sum 不匹配” 的核心步骤！若跳过此步，文件损坏会导致安装到一半报错（如 <code>tarfile.ReadError: unexpected end of data</code>），需重新下载。</p>
<p class="maodian"><a name="_lab2_1_5"></a></p><h3>2. 安装路径选择</h3>
<ul><li>不建议安装到 <code>/root</code> 目录（避免权限问题，普通用户无法正常使用），默认 <code>~/miniconda3</code> 是最佳选择（仅当前用户可访问，避免多用户冲突）。</li><li>若需多用户共享，可安装到 <code>/opt/miniconda3</code>，但需管理员权限（<code>sudo ./xxx.sh</code>），且后续使用需注意权限分配。</li></ul>
<p class="maodian"><a name="_lab2_1_6"></a></p><h3>3. 初始化选项（conda init）的重要性</h3>
<p>若安装时误选 <code>no</code>，将无法直接在终端使用 <code>conda</code> 命令，需手动配置环境变量：</p>
<div class="jb51code"><pre class="brush:bash;"># 编辑 .bashrc 文件，添加 Miniconda 路径
echo 'export PATH="~/miniconda3/bin:$PATH"' >> ~/.bashrc
# 生效配置
source ~/.bashrc
</pre></div>
<p class="maodian"><a name="_lab2_1_7"></a></p><h3>4. 清理旧版本残留</h3>
<p>若之前安装过不完整的 Miniconda（如报错后中断），需先删除旧目录再重新安装，避免文件冲突：</p>
<div class="jb51code"><pre class="brush:bash;">rm -rf ~/miniconda3# 删除默认安装目录，若自定义过路径则替换为对应路径
</pre></div>
<p class="maodian"><a name="_lab2_1_8"></a></p><h3>5. 安装后优化</h3>
<p><strong>更新 conda</strong>：安装完成后建议立即更新到最新版本，提升稳定性：</p>
<div class="jb51code"><pre class="brush:bash;">conda update -n base -c defaults conda
</pre></div>
<p><strong>配置国内镜像源</strong>：默认源下载速度较慢，可添加清华 / 中科大镜像（解决 “conda install 卡住” 问题）：</p>
<div class="jb51code"><pre class="brush:bash;"># 添加清华镜像
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
</pre></div>
<p class="maodian"><a name="_lab2_1_9"></a></p><h3>6. 避免权限陷阱</h3>
<p>不要用 <code>sudo</code> 执行安装脚本（除非确需多用户共享），否则普通用户使用 <code>conda</code> 时可能出现 “权限不足”（如无法创建环境、安装包），需通过 <code>sudo chown -R $USER: $HOME/miniconda3</code> 修复权限。</p>
<p class="maodian"><a name="_label2"></a></p><h2>总结</h2>
<p>以上为个人经验，希望能给大家一个参考，也希望大家多多支持琼殿技术社区。</p>
頁:
[1]