1. 为什么推荐 Miniconda
很多人第一次接触 Conda,会在 Anaconda 和 Miniconda 之间犹豫。对于 Ubuntu 服务器、开发机和日常 Python 环境管理来说,Miniconda 往往更合适,因为它只是一个轻量安装器 :只带 conda、Python 以及少量必要包,不会一开始就塞进大量你暂时用不到的科学计算组件。这样做的好处是安装更轻、后续环境更可控,也更适合按项目拆分依赖。(Anaconda)
从工程实践看,Miniconda 的思路其实很像"先搭一个干净的包管理底座,再在其上创建项目级环境"。这样你后面无论是装 PyTorch、FastAPI,还是做 GPU 推理环境,都不会把系统 Python 弄乱。
2. 安装前先确认什么
在正式安装前,先看三件事:
2.1 系统架构是否匹配
官方当前支持的 Linux 目标架构主要是 64 位 x86 和 64 位 aarch64 。如果你是常见的 Intel/AMD Ubuntu 服务器,基本就是 x86_64;如果是某些 ARM 服务器,则可能是 aarch64。(Anaconda)
你可以先执行:
bash
uname -m
常见输出:
x86_64:普通 Intel/AMD 服务器aarch64:ARM64 服务器
2.2 glibc 版本是否满足要求
官方说明里写得很明确:最新 Miniconda 安装器要求 glibc >= 2.28 ,因此它不支持 Ubuntu 18.04 ,但支持 Ubuntu 20.04 及以上。这个点很关键,因为很多"脚本能下载但装不上"的问题,本质上不是网络问题,而是系统基础库版本过老。(Anaconda)
你可以这样检查:
bash
ldd --version
如果你是 Ubuntu 20.04、22.04、24.04,一般都没问题。
2.3 磁盘空间是否够用
官方给出的最低要求是 至少 400 MB 磁盘空间 ,同时建议优先安装到当前用户目录 ,这种方式通常不需要管理员权限,也更稳。(Anaconda)
3. Ubuntu 安装 Miniconda 的标准步骤
下面按官方 Linux 安装文档来走,步骤很稳。
3.1 下载安装脚本
如果你的机器是最常见的 x86_64,直接执行:
bash
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
这是官方 Linux x86_64 的安装脚本下载方式。官方同页也给出了 curl -O 版本;如果你是 ARM64,则需要下载对应的 linux-aarch64 安装器。(Anaconda)
3.2 可选:校验安装包完整性
这一步很多人会省略,但在服务器环境里其实挺值得做。官方建议下载安装器后,使用 SHA-256 校验本地文件,再与官方归档中的哈希值比较,确认安装包没有损坏或被篡改。(Anaconda)
示例命令:
bash
sha256sum Miniconda3-latest-Linux-x86_64.sh
3.3 运行安装脚本
bash
bash ~/Miniconda3-latest-Linux-x86_64.sh
接下来会进入交互安装流程。一般按下面方式处理就够了:
- 回车浏览协议内容
- 输入
yes接受协议 - 安装路径直接回车,使用默认目录
- 当提示是否初始化 Conda 时,输入
yes
官方 Linux 安装页就是这种命令行安装方式。(Anaconda)
3.4 刷新 shell 环境
如果安装时你已经选择了初始化,通常重新打开终端即可。对于 Bash,也可以直接执行:
bash
source ~/.bashrc
这样当前 shell 会立即加载 Conda 初始化代码。这个逻辑和 conda init 的官方说明是一致的。(Conda 文档)
3.5 验证是否安装成功
bash
conda --version
conda list
如果能正常输出版本和包列表,说明 Miniconda 已经装好了。官方安装文档也把 conda list 作为验证安装是否成功的方法之一。(Anaconda)
4. conda init 到底做了什么
很多人第一次看到 conda init bash,会觉得它像一个"神秘修复命令"。其实不是。
官方文档解释得很清楚:conda activate 和 conda deactivate 这类命令,不只是启动一个程序,而是直接影响当前 shell 的环境变量状态 ,所以 Conda 必须和你所在的 shell 交互。为此,conda init 会把一小段初始化代码写进对应 shell 的启动脚本中,例如 Bash 常见就是 ~/.bashrc。执行完后,大多数 shell 需要重新打开才能生效。(Conda 文档)
所以当你安装完发现:
bash
conda: command not found
别慌,通常执行:
bash
conda init bash
source ~/.bashrc
就能恢复。
5. 安装完成后第一件事:创建独立环境
这一步特别重要。不要把所有包都装进 base。官方环境管理文档明确说明,Conda 的核心能力就是创建、切换、导出和管理相互隔离的环境 。(Conda 文档)
比如你想创建一个 Python 3.11 的环境:
bash
conda create -n llm-gpu python=3.11 -y
conda activate llm-gpu
官方给出的标准形式也是这种 conda create -n 环境名 python=版本 的写法。(Conda 文档)
再验证一下当前环境:
bash
conda env list
python -V
which python
这样你后面装 PyTorch、Transformers、FastAPI,就都在这个环境里,不会污染系统默认 Python。
6. 常见问题与排查思路
6.1 安装完后 conda 找不到
最常见原因不是没装成功,而是 shell 还没初始化 。因为 Conda 需要和当前 shell 交互,conda init 后通常要重开终端才生效。(Conda 文档)
排查命令:
bash
conda init bash
source ~/.bashrc
conda --version
6.2 Ubuntu 18.04 装不上
这不是你命令写错了,而是官方当前最新安装器要求 glibc >= 2.28,而 Ubuntu 18.04 不满足这个条件。(Anaconda)
6.3 ARM 机器安装异常
官方说明中提到,linux-aarch64 的构建在某些 Raspberry Pi 场景下可能不兼容,因此如果你不是标准 ARM 服务器,而是某些特殊板卡,可能需要额外留意。(Anaconda)
6.4 为什么建议装到当前用户目录
官方建议本地用户安装,因为这种方式通常不需要管理员权限 ,同时也更稳、更不容易影响整机其他用户。(Anaconda)
7. 一键复制版命令
如果你只是想快速装完,下面这组最实用。
7.1 安装 Miniconda
bash
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
bash ~/Miniconda3-latest-Linux-x86_64.sh
source ~/.bashrc
conda --version
conda list
7.2 创建开发环境
bash
conda create -n llm-gpu python=3.11 -y
conda activate llm-gpu
conda env list
python -V
7.3 如果 conda 命令找不到
bash
conda init bash
source ~/.bashrc
conda --version
这些命令分别对应官方 Linux 安装文档、conda init 命令说明以及环境管理文档中的标准流程。(Anaconda)
8. 总结
如果你只是想在 Ubuntu 上把 Conda 环境管理能力先搭起来,Miniconda 是比完整 Anaconda 更合适的起点。它轻量、干净、安装简单,而且非常适合服务器和项目隔离场景。安装时最关键的几个点其实只有四个:
- 确认系统是
x86_64还是aarch64 - 确认系统满足
glibc >= 2.28 - 安装时选择初始化 shell
- 安装完成后先创建独立环境,不要什么都装进
base