第2章：安装Snakemake：环境准备、Conda/Mamba安装、pip安装、验证安装
好，咱们正式开始动手。安装Snakemake看着简单，但这里头有几个坑。我当年第一次装的时候，直接pip install一把梭，结果环境乱成一锅粥。所以这一章，我带你走三条最稳的路。
不管你选哪条路，最终目标都一样：能在终端里敲出snakemake --version，并且看到版本号。我们开始吧。
2.1 环境准备：三条路，你选哪条？
Snakemake本质上是个Python包。装Python包，无非就是Conda/Mamba、pip，或者直接系统级安装。我个人强烈建议你选Mamba。为什么？因为快。你想想看，Conda解析依赖有时候能卡住半小时，Mamba十秒搞定。
下面的表格能帮你快速决策：
| 安装方式 | 适用场景 | 我的建议 |
|---|---|---|
| Conda/Mamba | 新手、多环境管理、生物信息学常用 | 首选，环境隔离最好 |
| pip | 已有Python环境、想快速尝鲜 | 适合老手，但要小心依赖冲突 |
| 系统包管理器 | Linux用户、想全局安装 | 不推荐，升级麻烦 |
我个人习惯，所有生信项目都用Mamba。原因很简单：隔离干净。你不想因为装一个流程工具，把系统Python搞崩了吧？
2.2 方案一：通过Conda/Mamba安装（推荐）
这是最稳妥的方式。Mamba就是Conda的加速版，命令几乎一样。
2.2.1 先装Mambaforge
别去官网下载Anaconda那个臃肿的包。我们用Miniforge，轻量、干净。
打开终端，直接跑：
wget https://github.com/conda-forge/miniforge/releases/latest/download/Mambaforge-$(uname)-$(uname -m).sh
bash Mambaforge-$(uname)-$(uname -m).sh一路yes过去就行。注意它会问你装在哪，默认$HOME/mambaforge，可以不改。
装好之后，关闭重启终端，或者直接source ~/.bashrc。这时你敲：
mamba --version能看到版本号，说明Mamba已经就绪。
小技巧： 如果你用的是zsh（macOS默认），记得把~/.bashrc换成~/.zshrc。
2.2.2 创建专用环境并安装Snakemake
我不建议把Snakemake装在base环境里。你想想看，万一你同时用好几个流程工具，环境冲突起来可麻烦了。
创建一个干净环境，Python版本选3.9或3.10，稳定：
mamba create -n snakemake -c conda-forge -c bioconda python=3.10 snakemake这里解释一下参数：
-n snakemake：环境名叫snakemake-c conda-forge -c bioconda：指定频道，bioconda是生信软件的大本营python=3.10：指定Python版本snakemake：要装的包
等它下载安装。我第一次装的时候，看到它解析依赖花了挺久，但比Conda快多了。
激活环境：
mamba activate snakemake你可能会看到一个(snakemake)前缀出现在终端里。嗯，这就对了。
2.3 方案二：通过pip安装
如果你手头已经有现成的Python环境（比如pyenv管理的），或者你只是想在服务器上快速试试，pip也能搞定。
注意： pip安装可能缺少一些系统级依赖，比如Graphviz（画流程图用）。万一后面画依赖图报错，别慌，补装就行。
直接：
pip install snakemake或者你想装最新开发版：
pip install git+https://github.com/snakemake/snakemake.git我不建议在生产环境用开发版。我在测试新功能时用过几次，结果遇到了不兼容的配置项，拖了半天才排查出来。
2.4 方案三：验证安装
不管用哪种方法装，最后都要验证一下。验证步骤很简单，但能帮你省不少事。
激活你的环境（如果用Conda/Mamba的话）：
mamba activate snakemake然后：
snakemake --version你应该能看到类似7.32.4这样的版本号。
接着，跑一个最简单的测试：
snakemake -h如果能看到一大串帮助信息，说明安装完美。
我把常见验证项列在下面，你可以逐条检查：
| 验证项 | 命令 | 预期结果 |
|---|---|---|
| 版本号 | snakemake --version |
显示类似 7.32.4 |
| 帮助信息 | snakemake -h |
显示完整帮助 |
| 核心模块 | python -c "import snakemake; print(snakemake.__version__)" |
同上版本号 |
| 可视化支持 | snakemake --dag --help |
不报错即可 |
避坑提示： 如果你安装后输入snakemake却提示command not found，八成是环境没激活。我曾经犯过这个错，在终端里敲了半天才发现还在base环境里。
2.5 安装流程总览
下面这张图，我把整个安装决策流程画出来了。你看一眼就能明白该走哪条路。
2.6 常见问题与排查
装完如果遇到问题，别急。我把自己踩过的坑和网上常见的报错整理了一下。
常见报错1： conda: command not found
原因：Mambaforge没添加到PATH，或者终端没重启。
解决：export PATH=~/mambaforge/bin:$PATH，或者重新打开终端。
常见报错2： Snakemake安装后import报错
原因：通常是因为系统Python和Conda环境的Python混用了。
解决：检查which python和which snakemake，确保它们都在同一个环境里。
我的做法： 每次新开终端，第一件事就是mamba activate snakemake。把环境激活写成肌肉记忆，能省掉不少头疼的事。
装好之后，我建议你直接创建一个空目录，写一个最简单的Snakefile试试。就一行rule all: input: "test.txt"，然后运行snakemake -n看能不能跑通。这一步能验证整个安装链条没问题。