CI/CD / 系统课时
用表达式控制步骤是否执行
用表达式控制步骤是否执行
同一条流水线通常不应在所有事件、分支和前序状态下执行完全相同的步骤。本节通过一个可手动验证的工作流,使用表达式与 if 控制执行路径,并解释多个条件、成功状态和失败后处理的边界。
学习目标
- 使用
if根据事件、分支和运行数据决定步骤是否执行 - 用
&&、||和比较运算组合多个条件 - 正确使用
success()、failure()和always()处理前序执行结果
if 在步骤运行前做判断
Step 的 if 条件为真时才执行该步骤,为假时该步骤会被跳过。条件可以读取 github 等 contexts,因此很适合表达“只在某种触发方式或某条分支执行”的规则。
例如下面的条件要求事件是 push,并且当前引用是 main:
if: github.event_name == 'push' && github.ref == 'refs/heads/main'这是片段示例,需要放在 Job 或 Step 等支持 if 的位置。这里可以省略 ${{ }},因为 if 字段会自动按表达式求值;在其他字段中引用表达式时,通常仍需要 ${{ ... }}。
用一个工作流观察执行路径
下面的工作流支持手动触发,并通过输入值模拟是否让测试步骤失败。这样无需修改代码,就能观察普通条件和状态检查函数如何改变后续步骤。
name: Expression demo
on:
workflow_dispatch:
inputs:
fail_test:
description: Fail the test step
required: true
type: boolean
default: false
jobs:
check:
runs-on: ubuntu-latest
steps:
- name: Show manual trigger
if: github.event_name == 'workflow_dispatch'
run: echo "manual trigger"
- name: Run simulated test
run: |
if [ "${{ inputs.fail_test }}" = "true" ]; then
echo "test failed"
exit 1
fi
echo "test passed"
- name: Run after success
if: ${{ success() }}
run: echo "previous steps succeeded"
- name: Report failure
if: ${{ failure() }}
run: echo "a previous step failed"
- name: Always clean up
if: ${{ always() }}
run: echo "cleanup"当 fail_test 使用默认值 false 时,预期输出中的关键内容为:
manual trigger
test passed
previous steps succeeded
cleanup当把 fail_test 设为 true 时,模拟测试返回非零退出码,Run after success 被跳过,关键输出变为:
manual trigger
test failed
a previous step failed
cleanupGitHub Actions 日志还会包含 Runner 自身生成的信息,因此实际日志不会只有上述几行;验证时关注这些步骤是否执行以及对应文本即可。

状态检查函数不是普通布尔变量
没有显式状态检查函数时,后续步骤通常隐含成功状态要求。因此,当你希望失败后仍运行诊断逻辑时,应明确使用 failure();希望无论前序结果如何都执行时,可以使用 always()。
always() 常用于必须尝试执行的收尾动作,但不要因此把所有清理逻辑都无条件化。某些操作依赖前一步生成的文件或资源,执行前仍应检查必要条件,否则原始故障之后还可能产生新的无关错误。
组合条件时保持可读性
表达式支持 ==、!=、&&、|| 和 ! 等常用运算。条件开始变长时,不要为了少写一个 Step 而堆叠大量逻辑;部署、发布、诊断等职责差异明显的路径更适合拆成独立 Step 或 Job。
判断一个 if 是否清晰,可以直接把它读成一句话:在什么事件或分支下,并且前序处于什么状态时,执行什么动作。只要这句话开始出现多个难以追踪的分支,就应该拆分执行路径,而不是继续扩展单个表达式。