第2节：Snakemake安装与环境配置归纳总结

2.1 为什么要把安装单独拎出来说？

你可能觉得——“装个工具嘛，pip install 就完事了”。嗯，我一开始也这么想。直到我在一个老旧集群上折腾了三个小时，才发现 Snakemake 对 Python 版本和依赖链有隐藏要求。说白了，这一步没走稳，后面所有重试策略、批处理逻辑全白搭。

我个人习惯是：先定环境，再装工具。别急着敲命令。

2.2 基础安装方式对比

Snakemake 最常见的安装方式有三种。我把它们的优缺点列了个表，你照着挑就行。

pip install snakemake

conda install -c bioconda -c conda-forge snakemake

mamba create -n snakemake_env snakemake

我个人的选择：只要不是在公司封闭内网，我都用 mamba。为什么？因为 conda 解析那几十个依赖的时间，够你喝两杯咖啡了。而 pip 呢？有一次我在服务器上 pip 直接装了新版 Snakemake，结果和系统 Python 的 numpy 版本冲突，导致 workflow 跑到一半报错——那个下午我都花在重新建环境上。

2.3 推荐环境配置流程

下面是我在多个项目中验证过的标准流程。你照这个走，基本不会出大问题。

1. 安装 mamba（如果还没装）
   

   conda install -n base -c conda-forge mamba

   或者直接下载 Miniforge 版本，自带 mamba。
2. 创建专用环境
   

   mamba create -n snakemake_env python=3.10 snakemake=8.0.1

   为什么不装最新版？因为有些集群的调度器版本对最新版 Snakemake 的 REST API 支持不完善。我个人习惯锁定一个已知稳定的版本——比如 8.0.1 我就验证过很多次。
3. 激活环境
   

   conda activate snakemake_env

4. 验证安装
   

   snakemake --version

   正常应该输出类似 8.0.1 的版本号。
5. 跑一个最小测试
   创建一个测试目录，写入 Snakefile：
   

   rule test_install:
       output: "test.txt"
       shell:
           "echo 'Snakemake installed successfully' > {output}"

   然后执行 snakemake -c1。如果看到绿色输出，说明环境全部就绪。

2.4 核心依赖与可选组件

Snakemake 的安装不仅仅是它自己。它依赖几个关键库，如果你要使用集群或重试功能，还有一些可选组件。下面这张表帮你理清楚。

关于 conda 集成：Snakemake 本身支持 --use-conda 参数，可以在 rule 级别自动创建 conda 环境。但前提是你得在全局安装了 conda 或 mamba，并且把它们的路径加到 PATH 里。如果你跳过这一步，运行 snakemake --use-conda 时会报错“Conda not found”。

2.5 环境配置的常见坑（我踩过的）

• Python 版本不一致：用 conda activate 激活环境后，一定确认 python --version 是否和预期一致。有时候系统默认 Python 覆盖了 conda 的，尤其是在 ~/.bashrc 里硬编码了 alias。
• 权限问题：在共享集群上，mamba 安装到自己的 home 目录可能会因为磁盘配额不足失败。我建议用 mamba install --prefix /some/shared/scratch/snakemake_env 指定安装位置，或者联系管理员给 home 扩容。
• 网络代理：公司内网或学校机房，pip 和 conda 经常连不上。你需要先设置好 HTTP_PROXY 和 HTTPS_PROXY 环境变量。我习惯写在 .condarc 里：
  

  channel_alias: https://mirrors.tuna.tsinghua.edu.cn/anaconda
  channels:
    - conda-forge
    - bioconda
    - defaults

  这样国内用户速度快得多。
• 版本号兼容：Snakemake 8.x 开始不再支持 --cluster 参数，改用 --profile。如果你的教程是旧的，用 7.x 的配置，那就要注意。我亲眼见过同事照着博客一步步配 cluster，结果命令狂报错——最后发现版本不对。

2.6 核心流程：从环境到第一个 workflow

我把整个流程画成了一张图。你看完就知道每一步该干什么，该检查什么。

上面这张图我故意把“安装 mamba”放在第一步，因为很多人先装 conda 再装 mamba，结果 conda 版本太旧连 mamba 都装不上。直接装 Miniforge 一步到位。

2.7 验证环境的终极方法

很多教程只让你跑 snakemake --version，但那个只能说明核心模块加载成功。要验证集群、重试、并行这些能力，还得做一步：写一个会失败的 rule，然后试试 --restart-times 参数。这才是我们这门课的真正起点。

你可以创建一个测试 Snakefile：

rule fail_once:
    output: "retry_test.txt"
    shell:
        """
        if [ ! -f .retry_marker ]; then
            touch .retry_marker
            exit 1
        fi
        echo "第二次重试成功" > {output}
        """

执行 snakemake -c1 --restart-times 2。如果第二次运行成功，说明重试机制已经就绪。这个测试我每次换环境都会跑一遍——毕竟后面整门课都靠它吃饭。