Conda/Mamba 环境管理进阶¶

一句话概述：Conda 是生信领域最主流的包管理器和环境管理器，Mamba 是 Conda 的加速版（C++ 重写依赖解析，速度快 10-100 倍），掌握好环境管理是生信分析的基本功。

核心知识点¶

概念	白话解释
Environment	环境 = 独立的软件空间（不同项目用不同环境，互不冲突）
Channel	频道 = 软件包的来源仓库（conda-forge, bioconda）
Solver	求解器 = 计算依赖关系的引擎（Mamba 比 Conda 快得多）
YAML 环境文件	用文件描述环境，方便复现
Micromamba	最轻量版（单个二进制文件，不装 base 环境）
Channel Priority	频道优先级 = 多个频道有同名包时用哪个

安装配置¶

# === 安装 Miniforge（推荐，自带 Mamba + conda-forge） ===
wget "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Linux-x86_64.sh"
bash Miniforge3-Linux-x86_64.sh  # 安装

# === 或安装 Micromamba（最轻量） ===
"${SHELL}" <(curl -L micro.mamba.pm/install.sh)  # 一键安装

# === 频道配置（生信必须） ===
conda config --add channels defaults       # 默认频道
conda config --add channels bioconda        # 生信软件频道
conda config --add channels conda-forge     # 社区维护的大频道
conda config --set channel_priority strict  # 严格优先级（防止跨频道冲突）

# 验证配置
conda config --show channels  # 应该是 conda-forge > bioconda > defaults

基本使用¶

1. 环境管理¶

# 创建环境
conda create -n bioinfo python=3.12  # 创建名为 bioinfo 的环境
mamba create -n qc_tools python=3.11 fastqc=0.12 multiqc  # Mamba 更快

# 激活/退出环境
conda activate bioinfo  # 激活环境
conda deactivate        # 退出环境

# 列出环境
conda env list  # 列出所有环境

# 删除环境
conda env remove -n old_env  # 删除环境

# 克隆环境
conda create -n bioinfo_copy --clone bioinfo  # 复制一个环境

2. 包管理¶

# 安装包
mamba install samtools=1.19 bwa=0.7.17 -n bioinfo  # 指定环境安装
conda install -c bioconda fastp  # 从 bioconda 频道安装

# 搜索包
mamba search samtools  # 搜索可用版本
conda search -c bioconda "star"  # 在 bioconda 搜索

# 更新包
mamba update samtools  # 更新特定包
mamba update --all     # 更新所有包

# 卸载包
conda remove samtools  # 卸载包

# 查看已安装
conda list              # 当前环境所有包
conda list | grep sam   # 过滤查找

3. 环境文件（可复现的关键）¶

# environment.yml — 环境配置文件
name: metagenome_analysis  # 环境名
channels:
  - conda-forge  # 频道优先级从上到下
  - bioconda
  - defaults
dependencies:
  - python=3.12
  - samtools=1.19
  - bwa=0.7.17
  - fastp=0.23.4
  - megahit=1.2.9
  - kraken2=2.1.3
  - bracken=2.9
  - metaphlan=4.1
  - pandas=2.2
  - matplotlib=3.8
  - pip:  # 用 pip 安装 Conda 没有的包
    - biopython==1.83

# 从文件创建环境
mamba env create -f environment.yml  # 创建
mamba env update -f environment.yml  # 更新（已有环境追加新包）

# 导出环境
conda env export > environment.yml       # 导出完整环境（含所有间接依赖）
conda env export --from-history > env.yml  # 只导出手动安装的包（推荐）

# 跨平台环境文件
conda list --explicit > spec-file.txt    # 导出精确规格文件（含下载URL）
conda create --name new_env --file spec-file.txt  # 精确复现

高级用法¶

1. 多环境项目管理¶

# 生信项目推荐的环境划分
mamba create -n qc_tools fastqc multiqc fastp trimmomatic  # 质控工具
mamba create -n alignment bwa samtools picard gatk4         # 比对工具
mamba create -n taxonomy kraken2 bracken metaphlan          # 物种分类
mamba create -n assembly megahit spades metabat2            # 组装工具
mamba create -n stats r-base r-ggplot2 r-dplyr              # 统计分析

# 用 conda run 不激活环境直接运行
conda run -n qc_tools fastqc sample.fastq.gz  # 在 qc_tools 环境中运行

2. 环境栈（嵌套激活）¶

conda activate base
conda activate --stack qc_tools  # 在 base 之上叠加 qc_tools
# 可以同时用两个环境的工具

3. 环境变量管理¶

# 在环境激活时自动设置环境变量
mkdir -p $CONDA_PREFIX/etc/conda/activate.d
echo 'export REFERENCE_DIR=/data/references' > $CONDA_PREFIX/etc/conda/activate.d/env_vars.sh
# 激活环境时自动设置 REFERENCE_DIR

4. 锁定文件（精确复现）¶

# 使用 conda-lock 生成跨平台锁定文件
pip install conda-lock
conda-lock -f environment.yml -p linux-64  # 生成锁定文件
conda-lock install conda-lock.yml           # 从锁定文件创建环境

常见报错¶

报错信息	原因	解决方法
`Solving environment: failed`	依赖冲突	用 Mamba 替代 Conda，或放宽版本约束
`PackagesNotFoundError`	包不存在	检查频道配置，添加 bioconda
`CondaEnvException: prefix already exists`	环境已存在	换名字或先删除
`ResolvePackageNotFound`	平台不支持	检查包是否支持你的系统
`ClobberError`	包文件冲突	`conda clean --all` 清理缓存
安装极慢	Conda 默认求解器慢	切换到 Mamba

速查表¶

# === 环境管理 ===
conda create -n name python=3.12     # 创建
conda activate name                   # 激活
conda deactivate                      # 退出
conda env list                        # 列出
conda env remove -n name              # 删除
conda env export > env.yml            # 导出
mamba env create -f env.yml           # 从文件创建

# === 包管理 ===
mamba install pkg                     # 安装（推荐用 mamba）
mamba install pkg=1.0                 # 安装指定版本
mamba search pkg                      # 搜索
conda list                            # 列出已安装
conda remove pkg                      # 卸载
mamba update --all                    # 全部更新

# === 清理 ===
conda clean --all                     # 清理缓存（释放磁盘）
conda clean --tarballs                # 只清理下载缓存

# === 配置 ===
conda config --show                   # 查看所有配置
conda config --show channels          # 查看频道
conda config --set auto_activate_base false  # 关闭自动激活 base

# === Conda vs Mamba vs Micromamba ===
# Conda:      默认管理器，求解器较慢
# Mamba:      快速求解器（C++ 重写），命令相同
# Micromamba:  最轻量（单文件，不需 base 环境）

参考：Conda 文档 | Mamba 文档 | 更新于 2026 年