Github Actions中set-output传递提交消息变量创建目录报错求助

你遇到的mkdir: missing operand错误，本质是steps.folder-name.outputs.TEXT没有获取到有效内容，导致mkdir命令缺少目录名参数。下面是具体的问题分析和解决方法：

问题原因 #

1. 上下文变量不匹配触发事件：github.event.head_commit.message仅在push事件中有效，如果你的Workflow由pull_request、workflow_dispatch等其他事件触发，这个变量会是空值。
2. 旧版set-output的兼容性问题：::set-output语法已被GitHub Actions弃用，处理提交消息中的空格、换行、引号等特殊字符时容易出现解析错误。
3. 未处理目录名非法字符：提交消息可能包含空格、换行或系统不允许的目录名字符，直接传递会导致命令执行失败。

解决方法 #

1. 选择正确的提交消息变量 #

根据Workflow触发事件，使用对应的变量获取提交消息：

• Push事件：github.event.head_commit.message
• Pull Request事件：github.event.pull_request.head.commit.message
• 通用场景（任意事件）：用Git命令直接获取最新提交消息：git log -1 --pretty=%B

2. 改用新版输出方式（推荐） #

弃用::set-output，使用GITHUB_OUTPUT环境变量传递输出，同时对提交消息做清洗处理：

- name: Store commit message for folder name
  id: folder-name
  run: |
    # 这里以push事件为例，其他事件替换成对应变量或Git命令
    COMMIT_MSG="${{ github.event.head_commit.message }}"
    # 只取提交消息第一行（避免换行），并将非法字符替换为下划线
    CLEANED_MSG=$(echo "$COMMIT_MSG" | head -n 1 | sed 's/[^a-zA-Z0-9_-]/_/g')
    # 将清洗后的值写入输出
    echo "TEXT=$CLEANED_MSG" >> "$GITHUB_OUTPUT"

3. 安全创建目录 #

创建目录时用双引号包裹变量，避免空格导致的参数拆分：

- name: Create directory
  run: mkdir -p "${{ steps.folder-name.outputs.TEXT }}"

额外调试步骤 #

如果仍出现空值问题，可以在存储输出的步骤中添加调试打印，确认提交消息是否正确获取：

- name: Store commit message for folder name
  id: folder-name
  run: |
    COMMIT_MSG="${{ github.event.head_commit.message }}"
    echo "原始提交消息: $COMMIT_MSG"
    CLEANED_MSG=$(echo "$COMMIT_MSG" | head -n 1 | sed 's/[^a-zA-Z0-9_-]/_/g')
    echo "清洗后消息: $CLEANED_MSG"
    echo "TEXT=$CLEANED_MSG" >> "$GITHUB_OUTPUT"

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