如何从GitHub Actions侧边栏排除可重用工作流并修复显示异常？

一、阻止可重用工作流被误触发 #

仅声明workflow_call事件的工作流本不应被独立触发，若出现推送时排队/运行的情况，可在jobs中添加执行条件，确保只有被其他工作流调用时才运行：

name: HTTP Download
on:
  workflow_call:
    ...
jobs:
  your-job-name:
    if: github.event_name == 'workflow_call' # 仅当被调用时执行
    ...

二、优化侧边栏显示（无法完全隐藏） #

GitHub目前没有完全隐藏可重用工作流的选项，禁用后仍会显示在侧边栏，但可通过以下方式优化：

• 将所有可重用工作流放在统一子目录（如.github/workflows/reusable/），GitHub会自动按目录分组显示，便于区分
• 在name字段前添加标识（如name: "[可重用] HTTP Download"），快速识别这类工作流
• 禁用工作流后，它会显示为灰色已禁用状态，不会被误触发

三、修复工作流显示路径而非name的问题 #

若部分工作流只显示文件路径而非name字段定义的名称，检查以下几点：

• 确认name字段在YAML文件最顶层，与on、jobs同级，无缩进错误
• 检查YAML文件是否存在语法错误（如冒号后缺空格、缩进不一致），导致GitHub无法正确解析name字段
• 推送修改后等待数分钟，GitHub可能需要刷新缓存才能更新显示名称

内容的提问来源于stack exchange，提问作者Josh M.