4、子工作流的参数传递：输入参数的定义、默认值、类型检查和传递方式

做 Nextflow 工作流开发，子工作流最容易出问题的地方在哪？我觉得就是参数传递。你想想看，主流程和子工作流之间如果没有一个清晰的参数接口，数据就很可能传错位，甚至根本传不过去。我个人习惯把它叫作“工作流的脐带”，断不得。

本章咱们就专门聊聊参数传递这件事。从定义、默认值、类型检查到传递方式，挨个捋清楚。

4.1 输入参数的定义

在 Nextflow 里定义子工作流的输入参数，得用 params 关键字，写在 main.nf 或者一个独立的配置文件里。举个例子：

// main.nf
params.input_file = "$projectDir/data/sample.fastq"
params.outdir = "./results"
params.genome = "hg38"

这里有个坑——参数定义一定要放在工作流最外层。我记得刚开始学的时候，把参数写在了 process 的头部，结果子工作流根本读不到。作用域不对，传什么都没用。

还有就是，参数名尽量用全小写加下划线，别用驼峰。我跟团队定过一个约定：所有外部参数必须带 params. 前缀，内部变量则不用。这样读代码时一眼就能看出哪些是外部输入。

4.2 默认值和类型检查

给参数设默认值是个好习惯。这样即使调用方忘了传，工作流至少能跑起来。我建议所有对外暴露的参数都要有默认值，哪怕只是一个临时占位符。

// nextflow.config
params {
  input_file = "data/input.txt"
  output_dir = "./output"
  threads = 4
  verbose = false
}

类型检查呢？Nextflow 本身是动态类型，但我个人会加上一些校验，防止吃错类型。比如：

// 检验参数类型
if (!params.input_file instanceof Path) {
  error "input_file 必须是文件路径"
}
if (!params.threads instanceof Integer || params.threads < 1) {
  error "threads 必须是正整数"
}

有一次，我们团队的一个同事没做类型检查，把 threads 传成了字符串"4"，结果下游的 process 直接报错。排查了一上午才找到原因。从那以后，我在所有对外接口里都加了类型断言。

参数类型	默认值示例	检查方式	常见问题
String	"input.txt"	instanceof CharSequence	传为空字符串
Integer	4	instanceof Integer	传成浮点数"4.0"
Boolean	false	instanceof Boolean	传成字符串"false"
Path	file("data/input.txt")	instanceof Path	传错路径不存在
List	[]	instanceof List	传成非可迭代对象

这个表格是我自己整理的，每次写新工作流都会对照着检查一遍。

4.3 参数传递方式

参数传递给子工作流主要有三种方式。说白了，就是参数从哪来、怎么进到子工作流里去。

1. 命令行参数：运行 nextflow run main.nf --input_file data/input.txt，最直接。适合临时测试，但参数多了容易漏传。
2. 配置文件传递：通过 nextflow.config 统一管理，适合多个参数。我在项目中遇到过一个跑生产流程的项目，参数有二十多个，用命令行根本记不住，后来全部迁到配置文件里，错误率直接降了八成。
3. 通道传递：适用于数据流的传递，不适用于固定配置。比如需要把 Channel.of(list) 传进子工作流做并行处理。

我个人更推荐配置文件的方式。因为一旦参数多了，敲命令行容易漏，而且不易追溯。我们团队现在的做法是：开发阶段用默认配置，部署时用 -params-file production.config 覆写覆盖。

// nextflow.config
params.input_file = "/path/to/input.bam"
params.sample_id = "sample_01"
params.genome = "GRCh38"
params.outdir = "/results/"

// 调用工作流时，可以覆盖
nextflow run main.nf -params-file production.config

还有一种方式是通过 workflow 的主体传入：

workflow {
    SubWorkflow(params.input_file, params.outdir)
}

嗯，这里要注意，子工作流的输入参数顺序和类型必须与定义一致，否则会静默传错值。我曾经花了一整天排查一个 bug，结果是参数顺序写反了：input_file 和 outdir 互换了，但 Nextflow 不会报错，因为两个都是字符串类型。

4.4 参数传递全流程示意图

你看这张图，参数从定义开始，经过配置读取、类型检查、值传递，最后被子工作流接收，然后在执行阶段使用。每一步如果出了问题，整个链路都会受影响。我在项目里遇到过参数定义对了但配置文件路径写错了的情况，结果跑了半天才发现用的全是默认值。

参数传递看似简单，但细节决定成败。现在每次写完子工作流，我都会先检查接口的参数定义是否清晰、默认值是否合理、类型校验是否到位。这样做，后续维护会省很多心。