如何在Snakemake的Shell中启用Bash别名展开？

问题场景 #

你通过配置文件指定工作流的程序执行路径，示例如下：

config.yaml（路径模式）

myProgram: /very/long/path/to/executable/build/myprogram

Snakefile

rule runMyProgram:
    input: "inputfile.txt"
    output: "outputfile.txt"
    shell: "{config[myProgram]} -i {input} -o {output}"

当你希望支持在配置文件中直接使用程序别名时：

config.yaml（别名模式）

myProgram: myprogram

若用户仅通过别名定义程序（未将程序加入$PATH），Snakemake调用的Shell会因默认关闭expand_aliases选项而无法识别别名，导致执行报错。即使在Shell指令或shell.prefix()中添加shopt -s expand_aliases也无法解决问题。

可行解决方案 #

1. 启动交互式Bash执行指令 #

Bash交互式模式默认开启别名展开，且会加载用户的shell配置文件（如~/.bashrc、~/.bash_aliases）。可以直接在规则的shell指令中指定以交互式模式运行bash：

rule runMyProgram:
    input: "inputfile.txt"
    output: "outputfile.txt"
    shell: "bash -i -c '{config[myProgram]} -i {input} -o {output}'"

注意：交互式模式会加载用户的全局shell配置，可能引入不必要的环境变量或指令，需评估是否符合工作流的隔离需求。

2. 手动加载别名文件并开启别名展开 #

如果不想使用交互式模式，可以显式加载用户存储别名的文件（如~/.bash_aliases），同时开启expand_aliases：

步骤1：在配置文件中指定别名文件路径（可选，让用户自定义）

myProgram: myprogram
alias_file: ~/.bash_aliases

步骤2：在Snakefile中设置全局Shell前缀

shell.prefix(f"source {config.get('alias_file', '~/.bash_aliases')} && shopt -s expand_aliases && ")

rule runMyProgram:
    input: "inputfile.txt"
    output: "outputfile.txt"
    shell: "{config[myProgram]} -i {input} -o {output}"

这种方式更可控，仅加载必要的别名定义，避免交互式模式的副作用。

为什么直接加shopt -s expand_aliases无效？ #

Bash在非交互式模式下默认不识别会话中定义的别名，且expand_aliases开启后，仅对后续定义或加载的别名生效。用户在本地shell中设置的别名不会自动传递给Snakemake启动的子shell，必须显式加载包含别名定义的文件才能让子shell识别。

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