在Nextflow脚本块中导入自定义Python模块报错应如何解决？

你当前的导入方式无法直接生效，原因如下：

Nextflow 每个进程都会创建独立的临时工作目录执行任务，Python 默认的模块搜索路径不包含你项目根目录下的bin/文件夹，因此无法定位到utilities.py文件，触发ModuleNotFoundError。

可用解决方案 #

• 方案1：进程脚本内临时添加模块搜索路径
  在你的Python代码导入自定义模块前，先将项目bin/目录加入Python的sys.path，可以直接使用Nextflow内置的$projectDir变量获取项目根目录路径，修改后的进程代码如下：

process transform_data {

    input:
    path(data)

    output:
    path("out.tsv"), emit: out_data

    script:
    """
    #!/usr/bin/env python3
    import sys
    # 加入项目bin目录到模块搜索路径
    sys.path.append("$projectDir/bin")
    import pandas as pd
    import io
    from utilities import print_info
    """
}

这个方案不需要修改全局配置，适合仅少数进程需要调用自定义模块的场景。

• 方案2：全局配置Python模块搜索路径
  如果需要在多个进程中调用该模块，可以在项目的nextflow.config配置文件中添加全局环境变量PYTHONPATH，一次配置所有进程都能直接导入模块：

// 写入项目根目录的nextflow.config文件
env {
    PYTHONPATH = "$projectDir/bin"
}

配置完成后，所有进程的Python脚本都可以直接用from utilities import print_info导入函数，不需要额外添加sys.path相关代码。

• 方案3：打包为可安装Python包
  如果你的自定义模块功能较多、需要跨项目复用，可以将utilities.py相关代码封装为标准Python包，通过pip install安装到你运行任务的Python环境中，之后可以在任意位置直接导入。

注意事项 #

如果你使用Docker、Singularity等容器运行Nextflow进程，需要额外将项目bin/目录挂载到容器内部，同时保证容器内的PYTHONPATH包含对应挂载路径，否则依然会找不到模块。

内容的提问来源于stack exchange，提问作者ljmesi