如何通过SSH命令或环境变量访问GitHub Actions的ACTIONS_STEP_DEBUG

完全可以，而且你不需要做任何额外配置——ACTIONS_STEP_DEBUG本身就是GitHub Actions运行时自动注入的内置环境变量，只有当你选择「带调试日志重跑工作流」时才会被设为true，常规运行时该变量值为false或不存在，直接拿来当调试开关就行。

Bash运行步骤内访问 #

run步骤默认继承运行器的全局环境，直接按shell读取环境变量的标准方式调用即可，不需要额外在workflow的env块里声明：

# 示例：调试模式下开启命令执行trace
if [[ "$ACTIONS_STEP_DEBUG" == "true" ]]; then
  echo "调试模式已开启，输出详细执行日志"
  set -x
fi

# 原有业务逻辑
echo "正常执行步骤命令"

Python代码中访问 #

Python脚本通过标准os模块读取环境变量即可，不需要额外通过命令行参数传值：

import os

# 读取调试开关，默认值设为false
is_debug = os.getenv("ACTIONS_STEP_DEBUG", "false").lower() == "true"

if is_debug:
    print("[DEBUG] 调试模式已启用，输出额外诊断信息")
    # 此处添加你的调试逻辑，比如打印中间变量、输出详细请求日志等

# 原有业务逻辑
print("执行正常业务流程")

SSH远程命令中读取 #

注意：SSH连接到远程服务器时，远程shell默认不会继承GitHub运行器的本地环境变量，必须手动透传该值，常用两种实现方式：

• 执行SSH命令时直接注入变量，适合短命令场景：

  ssh remote_user@remote_host "ACTIONS_STEP_DEBUG=${ACTIONS_STEP_DEBUG} bash -c '
    if [[ \"$ACTIONS_STEP_DEBUG\" == \"true\" ]]; then
      echo \"远程节点检测到调试模式开启\"
    fi
    # 此处填写需要在远程执行的业务命令
  '"
  

• 写入环境文件后传输到远程加载，适合长脚本场景：

  # 本地生成临时环境变量文件
  echo "export ACTIONS_STEP_DEBUG=${ACTIONS_STEP_DEBUG}" > .temp_debug_env
  # 将文件传输到远程服务器
  scp .temp_debug_env remote_user@remote_host:/tmp/
  # SSH连接后先加载环境变量，再执行业务脚本
  ssh remote_user@remote_host "source /tmp/.temp_debug_env && bash /path/to/your/remote/script.sh"
  # 执行完清理本地临时文件
  rm .temp_debug_env
  

注意：调试模式下输出日志时注意规避敏感信息，GitHub会自动掩码已配置的Secrets内容，但手动打印的业务敏感数据仍会明文展示。

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