如何在GitHub Actions工作流中正确激活conda环境

conda activate 报错的核心原因是：conda-incubator/setup-miniconda 执行每个 run 步骤时默认启动非登录shell，conda的shell初始化逻辑不会自动加载，此时直接调用conda activate就会触发「shell未正确配置」的报错。手动硬编码环境内二进制路径到PATH的方案维护成本极高，也不符合conda的使用规范，完全不需要这么做。

两种方案均经过验证，按需选择即可：

方案1：指定登录shell执行命令（改动最小，最推荐） #

setup-miniconda 官方明确要求，所有需要调用conda命令的run步骤，必须指定使用bash登录shell执行，这样步骤启动时会自动加载conda的初始化配置，conda activate 命令可以正常生效。
单步骤配置示例：

- name: Install and use samtools
  shell: bash -l {0} # 新增这行配置即可
  run: |
    set -x
    echo "begin: PATH=$PATH;"
    conda create -y --name samtools samtools
    conda activate samtools
    echo "after activate: PATH=$PATH;"
    which samtools # 此时可以正常识别到samtools路径

如果后续多个步骤都需要使用samtools所在的conda环境，可以在job级别全局配置默认shell，不用每个步骤重复添加：

jobs:
  tests:
    name: Tests
    runs-on: ubuntu-latest
    container: node:latest
    defaults:
      run:
        shell: bash -l {0} # 全局配置所有run步骤使用登录shell
    steps:
      # 后续所有run步骤无需单独配置shell，直接用conda activate即可

方案2：通过setup-miniconda直接创建并激活环境 #

可以直接在setup-miniconda的入参中指定需要安装的依赖，Action会自动完成环境创建、初始化和激活操作，不需要手动执行conda create和conda activate：

- uses: conda-incubator/setup-miniconda@v2
  with:
    miniconda-version: "latest"
    channels: bioconda, conda-forge, defaults
    use-only-tar-bz2: true
    auto-update-conda: true
    auto-activate-base: false
    create-args: samtools # 直接指定要安装的包，Action自动创建环境并激活

配置完成后，所有加了shell: bash -l {0}的run步骤中可以直接调用samtools，无需额外激活操作。

• 直接执行conda activate samtools：非登录shell没有加载conda注入的shell函数，触发初始化错误
• 执行$CONDA/bin/activate samtools：这是旧版本conda的激活方式，新版本conda不再支持直接调用bin目录下的activate脚本，必须通过初始化后的shell函数执行激活
• 硬编码3/envs/samtools/bin到PATH：当环境内安装的包增多、依赖复杂度上升时，需要手动处理大量二进制路径和优先级问题，可维护性极差，不推荐使用。

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