变量、密钥、上下文和表达式

本文档介绍 AtomGit Action 的四级变量体系、12 种上下文以及表达式语法，帮助在工作流中使用动态值和条件判断。

四级变量体系

类型	适合存储	是否敏感	引用方式
env	workflow 内部临时变量	否	$VAR_NAME 或 ${{ env.VAR }}
vars	仓库/组织级普通变量	否	${{ vars.VAR }}
secrets	密码、token、私钥	是	${{ secrets.NAME }}
inputs	Workflow 输入参数	否	${{ inputs.NAME }}

变量优先级

Step env  >  Job env  >  Workflow env

上下文

AtomGit Action 支持 12 种上下文，核心上下文名为 atomgit：

上下文	说明	典型属性
atomgit	工作流运行核心信息	atomgit.sha、atomgit.ref、atomgit.event_name
env	环境变量	env.VAR_NAME
vars	配置变量	vars.VAR_NAME
secrets	密钥	secrets.NAME
job	当前 Job 信息	job.status
steps	Step 信息与输出	steps.id.outputs.result
runner	Runner 信息	runner.os、runner.arch
inputs	输入参数	inputs.NAME
matrix	矩阵参数	matrix.os
strategy	矩阵策略信息	strategy.fail-fast

表达式

表达式通过 ${{ expression }} 语法嵌入 YAML 值中：

运算符：==、!=、!、&&、||

状态函数：

函数	说明
always	无论成功失败都执行

字符串函数：contains、startsWith、endsWith、format、substring、replace