GitHub Actions $GITHUB_STEP_SUMMARY写入Markdown摘要不显示如何解决

你的工作流配置语法没有错误，摘要无法展示是运行环境版本不满足功能最低要求导致的，大量使用自建GHES环境的开发者都碰到过同类问题。

两个核心版本限制你都没有达到：

• GHES端：$GITHUB_STEP_SUMMARY对应的Job Summary功能，在GHES 3.7.0版本才正式GA上线，你当前使用的v3.5.0版本没有内置该功能的后端解析、展示逻辑，就算runner正常上报了摘要内容，平台端也不会渲染展示。
• Runner端：该功能要求self-hosted runner版本最低为v2.297.0，你当前使用的v2.292.0版本运行时不会注入$GITHUB_STEP_SUMMARY环境变量，你执行echo追加命令时，实际是在工作目录下生成了一个名为$GITHUB_STEP_SUMMARY的普通本地文件，根本不会被runner识别、上传到GHES平台。

你可以在现有工作流中加入如下调试步骤确认环境状态：

- name: Check summary env
  run: |
    echo "GITHUB_STEP_SUMMARY value: [$GITHUB_STEP_SUMMARY]"
    if [ -n "$GITHUB_STEP_SUMMARY" ]; then ls -la $GITHUB_STEP_SUMMARY; fi

在你当前的环境下运行，你会看到输出的GITHUB_STEP_SUMMARY值为空，说明环境本身不支持该特性，和你的配置写法无关。

• 将GHES实例升级到3.7.0及以上的稳定版本
• 把所有self-hosted runner升级到v2.297.0及以上版本，推荐直接升级到最新稳定版避免其他功能兼容问题
• 升级完成后你现有的工作流配置不需要做任何修改，就可以正常展示步骤摘要内容

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