📚 课程目录第2章 Conda的安装与配置

第2章 Conda 的安装与配置：Linux、macOS、Windows

好，我们正式开始动手。Conda 的安装其实不复杂，但不同系统有各自的脾气。我个人习惯先把安装包下载好，再一步步配置环境变量。今天我们就把它一次搞定。

2.1 安装前的准备工作

在开始之前，先确认你的系统。不同平台下载的安装包不一样。我见过有人把 Windows 的 exe 下载到 Linux 上，结果折腾了半天。别犯这种低级错误。

你需要以下信息：

系统发行版与位数：Linux 下用 uname -m 查看，macOS 要区分 Intel (x86_64) 还是 Apple Silicon (arm64)
Python 基础版本：Conda 自带的 Python 是 3.x，但安装器会捆绑一个最小版本
磁盘空间：至少预留 3GB，实际占用可能更多

我个人习惯： 在安装前先看一眼 /tmp 目录的剩余空间。Conda 的安装脚本会解压大量文件到临时目录，空间不足会出现诡异的 IO 错误。

好，确认没问题后，我们按平台分别处理。

2.2 Linux 平台的安装

Linux 下最干净的方式是用官方 Shell 脚本安装。别用系统包管理器，你想想看，apt 或 yum 里的 Conda 版本经常落后半年以上。

先下载 Miniconda 安装脚本（我推荐用 Miniconda 而不是 Anaconda，轻量，够用）：

wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh

如果你是 ARM 架构（比如 AWS Graviton 实例），把 x86_64 换成 aarch64：

wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-aarch64.sh

下载完成后，校验一下 SHA256 值，确保文件没被篡改：

sha256sum Miniconda3-latest-Linux-x86_64.sh

然后执行安装。

bash Miniconda3-latest-Linux-x86_64.sh

你会看到许可证条款，按 q 跳过阅读，输入 yes 接受。然后选择安装路径，默认是 ~/miniconda3。我建议就放这里，方便管理和记忆。

注意： 安装过程中会问是否将 Conda 初始化到 shell 配置文件中。选 yes。这一步会自动在 .bashrc 或 .zshrc 里写入环境变量，省去手动配置的麻烦。我曾经遇到用户选了 no，结果每次都要 source ~/miniconda3/etc/profile.d/conda.sh，烦得很。

安装完成后的输出类似这样：

installation finished.
Do you wish the installer to initialize Miniconda3
by running conda init? [yes|no]
[yes] > yes

重新打开终端，或者 source ~/.bashrc 让配置生效。

2.3 macOS 平台的安装

macOS 的情况有点特殊。Intel 芯片和 M1/M2 芯片的安装包不一样。我最早用 Intel Mac 时还好，换了 M1 才发现踩了个坑——安装了 x86 版本的 Conda，后面跑 RNA-seq 工具时 CPU 架构混用，性能直接腰斩。

所以第一件事，确认你的芯片类型：

uname -m

输出 x86_64 是 Intel，arm64 是 Apple Silicon。

然后下载对应的安装包：

芯片类型	下载命令
Intel (x86_64)	`curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh`
Apple Silicon (arm64)	`curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-arm64.sh`

安装命令和 Linux 类似：

bash Miniconda3-latest-MacOSX-arm64.sh

安装过程中的步骤和 Linux 一样——接受条款、选路径、初始化 shell。完成后同样重启终端。

避坑指南： 如果你用 macOS 的 zsh（Catalina 及之后默认），Conda 会修改 .zshrc。如果你同时用 oh-my-zsh，可能会遇到插件冲突。我曾经遇到过 conda init 在 oh-my-zsh 环境下重复写入 PATH，导致 shell 启动慢了几秒。解决办法是手动清理 .zshrc 里的重复 conda 初始化块，只保留一份。

2.4 Windows 平台的安装

说实话，Windows 下的 Conda 安装最省心。直接下载图形化安装包，双击一路 next 就行。

去 Miniconda 官网找到 Windows 安装包（64 位版本）：

https://docs.conda.io/en/latest/miniconda.html

下载 Miniconda3-latest-Windows-x86_64.exe，双击运行。

安装过程中的几个关键选择：

安装路径：默认 C:\Users\你的用户名\miniconda3，别改到有空格的路径下，比如 C:\Program Files。Conda 在带空格的路径上偶尔会抽风
添加至 PATH：这个选项默认不勾选。我建议勾上「Add Miniconda3 to my PATH environment variable」
注册为系统 Python：不建议勾选，否则其他应用可能误用 Conda 里的 Python

安装完成后，打开「Anaconda Prompt」（开始菜单里能找到），输入 conda --version 验证。

注意： 如果你用 Windows Terminal 或 PowerShell，而不是 Anaconda Prompt，很可能找不到 conda 命令。为什么呢？因为 PowerShell 默认不会加载 conda 的初始化脚本。解决办法是每次打开新终端时手动运行：conda init powershell。别问我怎么知道的——我被这个问题耽误了整整一个下午。

2.5 配置环境变量（手动版）

如果你在安装时选择了「不初始化 shell」，或者像我一样在某些服务器上需要手动配置，这里给出手动添加环境变量的方法。

首先找到 Conda 的安装目录，假设是 /home/你的用户名/miniconda3。

打开 shell 配置文件，Linux/macOS 下一般是 ~/.bashrc 或 ~/.zshrc，在末尾添加：

# Conda 初始化
export CONDA_HOME="$HOME/miniconda3"
export PATH="$CONDA_HOME/bin:$PATH"

# 激活 Conda 命令补全（可选）
. "$CONDA_HOME/etc/profile.d/conda.sh"

保存后执行 source ~/.bashrc。

Windows 下手动配置 PATH：

右键「此电脑」→ 属性 → 高级系统设置 → 环境变量
在「系统变量」中找到 Path，双击编辑
添加 C:\Users\你的用户名\miniconda3 和 C:\Users\你的用户名\miniconda3\Scripts 这两条
一路点击确定保存

2.6 验证安装是否成功

不管什么平台，安装完后的第一步就是验证。打开终端或命令提示符，依次运行：

conda --version
conda info --envs
python --version

如果输出类似下面这样，就说明安装成功了：

conda 24.9.2
# conda environments:
#
base                  *  /home/你的用户名/miniconda3

Python 3.12.7

看到 base 前面有个星号了吗？那表示你当前正处在 Conda 的 base 环境里。这个 base 环境是系统的默认环境，R 和 Python 的 base 包都在里面。不过我们不会在里面直接干活，后续章节会教你用专门的环境跑 RNA-seq。

  为什么「conda info --envs」这么重要？

  这行命令能告诉你 Conda 是否找到了自己的环境目录。如果输出为空或报错，说明环境变量没配好，后面创建啥环境都白搭。我建议你把这行命令做成肌肉记忆，每次新装完系统都先跑一遍。

2.7 整体安装流程图

下面这张图总结了 Conda 安装和配置的核心流程。从平台识别到环境变量配置，再到最终验证，总共四个步骤：

2.8 安装后的小测试

好，你现在应该已经把 Conda 装好了。我建议多做一个快速测试，确保未来不会出幺蛾子——创建一个临时环境看看能不能用：

conda create -n test-env python=3.10 -y
conda activate test-env
python -c "print('Conda works!')"
conda deactivate

如果看到了 Conda works!，那恭喜你，整套安装流程完美收官。