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

四级变量体系

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

变量优先级

Step env  >  Job env  >  Workflow env

上下文

GitCode 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 值中：

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

状态函数：

函数	说明
success	前置步骤成功
always	无论成功失败都执行
cancelled	Workflow 被取消
failed	前置步骤失败

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

特殊函数：hashFiles、toJson