Nextflow 安装与配置

说实话，安装 Nextflow 本身并不复杂，但选对方法能让你少踩很多坑。我见过不少同事在 Mac 上用 brew 装完发现版本太旧，或者手动装完 PATH 配错导致命令找不到。下面我把三种主流方式——conda、brew、手动安装——的细节和避坑点都列出来。

三种安装方式

我个人习惯根据当前环境选：如果是纯 Python 项目或 Anaconda 用户，优先 conda；Mac 且不排斥 Homebrew 可试试 brew；生产服务器或需要固定版本的场景，手动安装最可控。

1. Conda 安装

Conda 是最省心的方式之一，一条命令搞定依赖。

conda install -c bioconda nextflow

你想想看，bioconda 频道下的 nextflow 包会额外帮你装好 Java（如果系统缺的话）。但我曾碰到一个问题：conda 默认装的 Java 版本是 11，而 Nextflow 有些特性需要 Java 17+。这时可以手动指定 Java 版本：

conda install -c bioconda nextflow openjdk=17

装完后运行 nextflow -version 验证。如果显示找不到命令，大概率是 conda 环境没激活，或者 PATH 未更新。退出终端重新进入即可。

2. Homebrew 安装（macOS）

Mac 用户用 brew 最顺手，但要注意 Nextflow 的 cask 被移到了 Homebrew/homebrew-core。正确命令是：

brew install nextflow

咦？等等，有的教程让你先 tap 一个第三方仓库，那都是旧方法了。现在直接 brew install 即可。我曾经试过旧方式导致版本错乱。

另外，brew 安装的 Nextflow 会放在 /usr/local/bin 或 /opt/homebrew/bin（Apple Silicon）。请确保该路径在 $PATH 中。

3. 手动安装（通用、推荐生产环境）

手动安装其实就两步：下载可执行文件，放到 PATH 下。我喜欢这种直接不依赖包管理器的感觉。

# 下载最新版（建议先查看 releases 页面）
wget -qO- https://github.com/nextflow-io/nextflow/releases/latest/download/nextflow-23.10.0-all

# 或者使用 curl
curl -s https://get.nextflow.io | bash

# 赋予执行权限
chmod +x nextflow

# 移动到 PATH 目录（例如 ~/.local/bin）
mv nextflow ~/.local/bin/
# 确认 ~/.local/bin 在 PATH 中
export PATH="$HOME/.local/bin:$PATH"

注意，手动安装需要系统中已有 Java 8/11/17（推荐 17）。检查 Java：java -version。如果 Java 未安装，手动装一个 OpenJDK 即可。

配置文件与环境变量

Nextflow 的行为由几个环境变量和配置文件控制。说白了，你不需要全部记住，但核心的几个必须知道。

配置文件的优先级是：命令行参数 > 环境变量 > 配置文件。Nextflow 会依次读取：

1. nextflow.config（当前目录）
2. $HOME/.nextflow/config（用户级）
3. 系统级（一般不推荐）

你可以把常用设置写在 ~/.nextflow/config 里，比如：

profiles {
    standard {
        process.executor = 'local'
        workDir = '/data/nextflow_work'
    }
    cluster {
        process.executor = 'slurm'
        workDir = '/scratch/nextflow_work'
    }
}

使用时通过 -profile cluster 切换环境。我曾经因为忘记设置 workDir，导致几千个任务在 /tmp 下写文件，磁盘爆满……从那以后我就把 workDir 写进配置文件了。

验证安装是否成功

不管用哪种方式，最后跑一个最简单的管道确认下：

nextflow run hello

这个官方 demo 会输出类似这样的信息：

 N E X T F L O W  ~  version 23.10.0
 Launching `hello.nf` [distracted_goldwasser] DSL2 - revision: 2a8a48bc33
 [d5/cf05b3] process > sayHello [100%] 1 of 1 ✔
 Louis Pasteur says: 'Hello, world!'

如果看到版本号和 hello 输出，恭喜你，环境搭好了。