如何用类对象语法创建GitHub环境变量以本地测试Bash脚本

首先明确：GitHub Actions里的github.event.client_payload是上下文变量，并非直接的Shell环境变量。在Workflow的run步骤中，${{ github.event.client_payload }}会被GitHub先替换为对应的JSON字符串，再交给Shell执行。如果直接把这段逻辑写成单独的Shell脚本运行，会因Shell不允许变量名包含.而报错，以下是几种可行的本地测试方案：

方案1：修改脚本适配本地环境（推荐） #

将脚本中的非法变量名替换为符合Shell规范的环境变量名，比如GITHUB_EVENT_CLIENT_PAYLOAD：

修改后的脚本（示例命名为test.sh）：

PAYLOAD=${GITHUB_EVENT_CLIENT_PAYLOAD}
echo "$PAYLOAD"

本地调用方式 #

• 直接在调用时传入环境变量：

GITHUB_EVENT_CLIENT_PAYLOAD='{"key": "value", "nested": {"foo": "bar"}}' bash test.sh

• 先导出环境变量再执行脚本：

export GITHUB_EVENT_CLIENT_PAYLOAD='{"key": "value", "nested": {"foo": "bar"}}'
./test.sh

方案2：不修改脚本，模拟GitHub表达式替换 #

如果需要完全复刻Workflow中的变量替换逻辑，可使用envsubst工具先替换脚本中的上下文变量，再执行：

1. 确保安装envsubst（Linux发行版通常自带，macOS可通过brew install gettext安装）
2. 执行以下命令：

export GITHUB_EVENT_CLIENT_PAYLOAD='{"key": "value", "nested": {"foo": "bar"}}'
envsubst '${github.event.client_payload}' < test.sh | bash

方案3：模拟完整GitHub上下文（进阶） #

如果脚本需要用到github.event下的多个嵌套属性，可以将完整的github.event JSON结构存入环境变量，用jq工具提取目标字段：

修改后的脚本：

# 从完整的github上下文JSON中提取client_payload
PAYLOAD=$(echo "$GITHUB_EVENT" | jq -r '.client_payload')
echo "$PAYLOAD"

本地调用方式 #

GITHUB_EVENT='{"event": "workflow_dispatch", "client_payload": {"key": "value", "nested": {"foo": "bar"}}}' bash test.sh

内容的提问来源于stack exchange，提问作者Marian Klühspies