2、Nextflow安装与配置

好，咱们正式开始动手。装Nextflow之前，得先看看你机器能不能跑。说白了，Nextflow就是个Java程序，所以Java环境是第一道坎。

系统要求

我遇到过不少新人拿着老掉牙的Java 8来跑，结果各种报错。Nextflow从2020年后就要求Java 11+了，而且官方推荐Java 17。这个坑我踩过一次，折腾半天才发现是Java版本太低。

另外，内存和CPU也别太抠。虽然Nextflow本身很轻量，但它要启动任务进程。你想想看，一个Pipeline里几十上百个任务同时跑，内存不够就会一直触发OOM。我一般建议至少8GB内存，4核以上。

安装方式：三条路，任你选

Nextflow安装非常灵活。我一般根据不同场景选不同方式：conda适合我管理多个环境时顺带安装；curl适合服务器上快速部署；手动下载适合离线环境。咱们一条条过。

1. 通过Conda安装

如果你已经用conda管理生物信息软件，那直接这样装：

conda install -c bioconda nextflow

装完会自动把可执行文件放到conda环境bin目录下，PATH不用额外操心。

但我建议你指定版本，别图省事：

conda install -c bioconda nextflow=23.10.0

为什么呢？因为bioconda频道有时候推送新版本但还没彻底稳定。我去年有个Pipeline就卡在24.01.0的一个bug上，回退到23.04.0就好了。所以，锁定版本是专业做法。

2. 通过curl / wget 安装（推荐）

这是官方最推荐的方式，也最常用。一条命令搞定：

curl -s https://get.nextflow.io | bash

或者用wget：

wget -qO- https://get.nextflow.io | bash

执行完当前目录会多出一个nextflow文件，是个可执行的shell脚本。你需要把它移到PATH目录里：

mv nextflow ~/bin/
# 或者
sudo mv nextflow /usr/local/bin/

然后给执行权限：

chmod +x ~/bin/nextflow

3. 手动下载安装

离线环境或内网服务器，老老实实手动下载：

# 去GitHub Release页面下载对应版本的压缩包
# 例如 v23.10.0
wget https://github.com/nextflow-io/nextflow/releases/download/v23.10.0/nextflow-23.10.0-all

# 重命名并移动到PATH
mv nextflow-23.10.0-all nextflow
chmod +x nextflow
sudo mv nextflow /usr/local/bin/

注意：GitHub Release里给的是nextflow-XX-all这个文件，它是打包好的jar包封装在shell脚本里的。别下错成源码zip，那个没法直接用。

环境变量配置

装完后，你得确认Nextflow能全局调用。如果你用conda安装，PATH里已经有conda的bin目录，可以直接nextflow -version测试。

如果你用curl或手动方式安装，而且没有放到系统标准PATH里，那就需要手动配置：

# 编辑 ~/.bashrc 或 ~/.bash_profile
export PATH=$PATH:$HOME/bin

# 让配置生效
source ~/.bashrc

然后验证：

nextflow -version

预期输出类似：

nextflow version 23.10.0.5880
nextflow build 5880
created: 01-10-2023 15:48 UTC

顺便说一句，Java版本也很关键。你可以用：

java -version

看看是不是11+。我曾遇到一个集群上默认Java是8，Nextflow启动就报Unsupported class file major version。解决办法要么升级系统Java，要么用JAVA_HOME环境变量指定一个高版本Java路径：

export JAVA_HOME=/path/to/jdk-17
export PATH=$JAVA_HOME/bin:$PATH

建议把这两行也加进~/.bashrc里，避免每次打开终端都设置。

一张图看懂安装流程

我把整个安装到验证的过程画成了流程图，方便你对照操作：

验证与常见问题

装完跑一个最简单的例子，确认一切正常：

nextflow run hello

这是Nextflow官方提供的最小流程，会打印几句问候语。如果屏幕上出现N E X T F L O W logo和任务完成信息，恭喜，安装成功！

小提示：多个版本管理

如果你需要在不同项目里切换Nextflow版本，我建议别覆盖系统级的nextflow，而是用NXF_HOME环境变量或者alias：

# 下载两个版本到不同目录
mkdir -p ~/nextflow/23.10.0/
cd ~/nextflow/23.10.0/ && curl -s https://get.nextflow.io | bash

mkdir -p ~/nextflow/24.04.0/
cd ~/nextflow/24.04.0/ && curl -s https://get.nextflow.io | bash

# 给版本起别名
alias nxf23="~/nextflow/23.10.0/nextflow"
alias nxf24="~/nextflow/24.04.0/nextflow"

这样你在不同项目里就能轻松切换，互不干扰。我之前一个Pipeline依赖老版语法，新版跑会报错，就是这个思路搞定的。