markdown
# Ubuntu 26.04 Miniforge3 安装与配置完整指南
## 📥 1. 下载安装脚本
使用清华镜像源下载 Miniforge3 安装脚本:
```bash
wget https://mirrors.tuna.tsinghua.edu.cn/github-release/conda-forge/miniforge/LatestRelease/Miniforge3-Linux-x86_64.sh
说明:Mambaforge 已于 2024 年 7 月起被官方弃用,现在推荐使用 Miniforge3。
🛠️ 2. 运行安装脚本
执行安装脚本:
bash
bash Miniforge3-Linux-x86_64.sh
安装过程选项说明与选择
安装过程中会依次出现以下交互选项:
| 步骤 | 提示内容 | 推荐选择 | 说明 |
|---|---|---|---|
| 1. 许可协议 | `Do you accept the license terms? [yes | no]` | 输入 yes |
| 2. 安装位置 | Miniforge3 will now be installed into this location: |
直接按 Enter |
默认安装到 ~/miniforge3,接受即可。 |
| 3. 初始化 | `Do you wish the installer to initialize Miniforge by running conda init? [yes | no]` | 输入 yes |
🔍 3. 验证安装与查看版本
安装完成后,关闭并重新打开终端,或执行以下命令刷新配置:
bash
source ~/.bashrc
验证安装:
bash
conda --version # 查看 conda 版本
python --version # 查看 Python 版本(Miniforge3 自带)
mamba --version # 查看 mamba 版本(Miniforge3 已内置)
⚙️ 4. 配置清华镜像源(加速包下载)
4.1 添加 conda 镜像源
依次执行以下命令,添加清华镜像源:
bash
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/
conda config --set show_channel_urls yes
注意 :上述命令添加的频道顺序决定了优先级,最后添加的优先级最高 。为了优先使用
conda-forge,可以将其放在最后添加。
4.2 配置验证与生效
清理缓存使配置立即生效:
bash
conda clean -i
查看当前频道列表,确认镜像源已成功添加:
bash
conda info
在输出信息中,找到 channel URLs 部分,应显示以 https://mirrors.tuna.tsinghua.edu.cn/ 开头的地址。
4.3 配置 pip 国内源(可选)
如果同时使用 pip 安装 Python 包,可以单独为其设置清华源:
bash
pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple
4.4 恢复默认源(如需)
如果后续想恢复 conda 的默认官方源,执行:
bash
conda config --remove-key channels
📋 5. 常用命令速查
| 功能分类 | 命令示例 | 说明 |
|---|---|---|
| 环境管理 | conda create -n myenv python=3.10 |
创建名为 myenv 的新环境,指定 Python 版本。 |
conda activate myenv |
激活 myenv 环境。 |
|
conda deactivate |
退出当前环境,回到 base。 |
|
conda env list |
列出所有 conda 环境。 | |
conda env export > environment.yml |
导出当前环境包列表到文件。 | |
| 包管理 | mamba install numpy |
使用 mamba 安装包(速度更快)。 |
conda install scipy |
使用 conda 安装包。 |
|
mamba search pandas |
搜索包及其可用版本。 | |
| 其他 | conda config --set auto_activate_base false |
关闭终端自动激活 base 环境。 |
conda info --base |
查看 Miniforge3 安装路径。 |
✅ 6. 完整安装流程总结
bash
# 1. 下载安装脚本
wget https://mirrors.tuna.tsinghua.edu.cn/github-release/conda-forge/miniforge/LatestRelease/Miniforge3-Linux-x86_64.sh
# 2. 执行安装(按提示交互操作)
bash Miniforge3-Linux-x86_64.sh
# 3. 刷新配置
source ~/.bashrc
# 4. 验证安装
conda --version
# 5. 配置清华镜像源
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/
conda config --set show_channel_urls yes
# 6. 清理缓存使配置生效
conda clean -i
# 7. (可选)配置 pip 国内源
pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple
# 8. 验证频道配置
conda info
📝 7. 注意事项
-
安装完成后,终端提示符前出现
(base)字样,表示 conda 基础环境已激活。 -
Miniforge3 默认使用
conda-forge频道,无需担心 Anaconda 的商业使用许可问题。 -
mamba是conda的高性能替代品,安装大型包或复杂环境时速度优势明显,Miniforge3 已内置。 -
配置镜像源后,包的下载速度将显著提升。
以上即是完整的 Markdown 源文件内容。你可以将其保存为
Miniforge3-Install-Guide.md或任意你喜欢的文件名,在支持 Markdown 的编辑器(如 VS Code、Typora 等)中打开即可查看排版后的文档。