📚 课程目录第2章 Snakemake安装与环境配置

第2章 Snakemake安装与环境配置

安装Snakemake，说白了就是给工作流找个靠谱的宿主。我刚开始搞生信流程时，图省事直接pip install snakemake怼进系统Python，结果后来给项目配依赖时差点没把自己气哭——版本冲突那叫一个酸爽。这节课咱们就把安装这件事掰开揉碎，把坑都填平。

2.1 安装方式：选对路子，省一半时间

Snakemake的安装方式主流就那么几种，但不同场景下选哪个差别很大。我个人习惯优先用Conda/Mamba，原因后面说。

安装方式	命令示例	适用场景	我的评价
pip	`pip install snakemake`	快速尝鲜、测试	简单但容易污染环境
Conda/Mamba	`conda install -c bioconda -c conda-forge snakemake`	生信项目推荐	依赖管理最省心
源码编译	`git clone https://github.com/snakemake/snakemake.git cd snakemake pip install -e .`	调试/二次开发	适合折腾党
Singularity/Docker	`docker pull snakemake/snakemake`	HPC集群隔离环境	集群部署首选

重点说说Conda。 你想想看，生物信息管道动不动要一堆R包、Python包甚至C库。pip管Python还行，但遇到底层工具（比如samtools、bwa）就抓瞎了。Conda的bioconda频道专门做这事。我在一个癌症突变检测项目里，就是靠conda把Snakemake+fastp+bwa+GATK一整套塞进一个环境，再也没出过“libc.so.6找不到”的灵异事件。

我的推荐组合： Mamba（Conda的C++加速版）+ conda-forge + bioconda。Mamba解析依赖的速度比裸conda快一个数量级，尤其是做大环境时差距明显。

mamba install -c bioconda -c conda-forge snakemake snakemake-minimal

避坑： 我曾经在conda环境中混装pip和conda的同名包，结果Snakemake启动时调用了错误的依赖版本。记住一条铁律：一个环境只用一个包管理器做主。 用conda创建环境，就尽量用conda装所有包；实在缺包再用pip——但装完后别跑conda install降级。

2.2 版本选择：追新还是保守？

Snakemake现在（2025年）稳定版已经到8.x，7.x还在维护。怎么选？

生产流水线：建议用7.x LTS（长期支持）版本。功能稳定，社区文档多。
新项目/个人学习：可以上8.x，新API和性能优化香得很。
团队协作：务必统一版本。我见过一个组里有人用5.x，有人用7.x，结果Snakefile里checkpoint语法不通，来回改了两天。

查当前版本很简单：

snakemake --version

如果想锁定版本，用Conda环境时直接指定：

mamba create -n snakemake7 -c bioconda -c conda-forge snakemake=7.32.4

小技巧： 把环境定义写进environment.yaml文件，版本号写死。这样同事或服务器上复现时，一行命令就能重建一模一样的环境。

name: snakemake7
channels:
  - bioconda
  - conda-forge
dependencies:
  - python=3.9
  - snakemake=7.32.4
  - graphviz

2.3 虚拟环境：规矩一点，不然后悔

嗯，这里要注意。虚拟环境不是可选项，是必选项。我入职第一家公司时，服务器上全局Python装了300多个包，那个混乱程度堪比大学宿舍。后来我给每个项目建独立环境，再也没因为“哎呀我把requests升级了结果pandas崩了”这种事加班。

三种常见的虚拟环境方案：

Python venv：轻量，只管Python包。适合纯Python项目。
Conda环境：跨语言，适合生信混合项目。我的首选。
Docker/Singularity：系统级别隔离，适合提交给HPC或分享给不同团队。

用Conda建环境：

mamba create -n myworkflow -c bioconda -c conda-forge python=3.10 snakemake=7.32.4
mamba activate myworkflow

用Docker拉镜像：

docker pull snakemake/snakemake:7.32.4
docker run -it --rm -v $(pwd):/work -w /work snakemake/snakemake:7.32.4 snakemake --cores 1

重要提示： 用Docker时注意挂载卷和用户ID。我曾在集群上跑容器，结果输出文件属主是root，其他用户删不掉。解决方案是启动时加--user $(id -u):$(id -g)。

2.4 环境配置的全局逻辑

最后我们画一张图，把整个安装-环境-版本-隔离的决策过程串起来。说白了就是：拿到需求 → 选包管理器 → 定版本 → 建干净环境 → 日常维护。

这张图其实挺直白的。你每次搭新环境，就从左到右过一遍：项目是纯Python还是生信？选哪个包管理器？要不要固定版本？环境要和别人共享吗？最后跑一下snakemake --version确认一切就绪。养成这个习惯，后面出错的概率至少降一半。

个人做法： 我每个项目目录里都会放一个env/子目录，里面存environment.yaml和requirements.txt。同时写个setup_env.sh脚本，队友克隆项目后直接bash setup_env.sh就完事。省时省力，也不怕有人漏装了包。

好，安装和环境配置就聊到这儿。记住：环境配得好，下班走得早。