Ubuntu 安装 Miniconda 完整从零开始把 Conda 环境搭起来

1. 为什么推荐 Miniconda

很多人第一次接触 Conda,会在 AnacondaMiniconda 之间犹豫。对于 Ubuntu 服务器、开发机和日常 Python 环境管理来说,Miniconda 往往更合适,因为它只是一个轻量安装器 :只带 conda、Python 以及少量必要包,不会一开始就塞进大量你暂时用不到的科学计算组件。这样做的好处是安装更轻、后续环境更可控,也更适合按项目拆分依赖。(Anaconda)

从工程实践看,Miniconda 的思路其实很像"先搭一个干净的包管理底座,再在其上创建项目级环境"。这样你后面无论是装 PyTorch、FastAPI,还是做 GPU 推理环境,都不会把系统 Python 弄乱。

2. 安装前先确认什么

在正式安装前,先看三件事:

2.1 系统架构是否匹配

官方当前支持的 Linux 目标架构主要是 64 位 x8664 位 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

接下来会进入交互安装流程。一般按下面方式处理就够了:

  1. 回车浏览协议内容
  2. 输入 yes 接受协议
  3. 安装路径直接回车,使用默认目录
  4. 当提示是否初始化 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 activateconda 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 更合适的起点。它轻量、干净、安装简单,而且非常适合服务器和项目隔离场景。安装时最关键的几个点其实只有四个:

  1. 确认系统是 x86_64 还是 aarch64
  2. 确认系统满足 glibc >= 2.28
  3. 安装时选择初始化 shell
  4. 安装完成后先创建独立环境,不要什么都装进 base
相关推荐
GL_Rain2 小时前
Ubuntu生成SSH私钥+连接CSDN GPU服务器(解决Permission denied问题)
服务器·ubuntu
枕布响丸辣2 小时前
万字详解 GlusterFS 分布式文件系统:原理 + 卷类型 + CentOS 7 集群部署
linux·运维·centos
Elivs.Xiang2 小时前
ubuntu20中安装Jenkins
linux·运维·ubuntu·jenkins
说再见再也见不到2 小时前
Ubuntu 将阿里云 OSS 对象存储挂载为本地硬盘(含开机自启)
linux·运维·服务器·ubuntu·阿里云·云计算
凤年徐2 小时前
自动化构建工具:make 与 Makefile
android·java·linux·自动化
拄杖忙学轻声码2 小时前
Linux平台 CentOS、Ubuntu、Debian 系统安装 docker compose
ubuntu·docker·centos
小樱花的樱花2 小时前
Linux Shell命令入门
linux·服务器·开发语言
艾莉丝努力练剑2 小时前
【Linux网络】计算机网络入门:从背景到协议,理解网络通信基础
linux·运维·服务器·c++·学习·计算机网络
艾莉丝努力练剑2 小时前
【Linux线程】Linux系统多线程(十):线程安全和重入、死锁相关话题
java·linux·运维·服务器·c++·学习·安全