GitHub Actions工作流徽章无法在Jekyll GitHub Pages显示的问题

问题原因 #

私有仓库的GitHub Actions状态徽章默认需要权限验证，而GitHub Pages静态页面加载徽章时，浏览器的请求不会携带GitHub认证信息，导致徽章被拦截无法显示。而仓库本地的coverage-badge.svg属于GitHub Pages托管的静态资源，shields.io的徽章是公开资源，因此可以正常加载。

解决方案 #

方案一：添加个人访问令牌（PAT）到徽章URL #

1. 在GitHub账号的「Settings」→「Developer settings」→「Personal access tokens」页面，创建一个具有repo权限的PAT（仅勾选必要权限，最小化风险）。
2. 修改README.md中的工作流徽章URL，在末尾追加?token=你的PAT参数，示例：

   ![pytest](https://github.com/preritdas/wooster-trading-systems/actions/workflows/pytest.yml/badge.svg?token=YOUR_PERSONAL_ACCESS_TOKEN)
   ![firebase](https://github.com/preritdas/wooster-trading-systems/actions/workflows/firebase-hosting-merge.yml/badge.svg?token=YOUR_PERSONAL_ACCESS_TOKEN)
   ![pages-build-deployment](https://github.com/preritdas/wooster-trading-systems/actions/workflows/pages/pages-build-deployment/badge.svg?token=YOUR_PERSONAL_ACCESS_TOKEN)
   

   注意：PAT拥有仓库访问权限，请勿泄露给无关人员；若担心安全，可创建仅拥有仓库只读权限的机器用户，使用其PAT替代。

方案二：改用shields.io生成工作流徽章（样式统一） #

shields.io支持通过GitHub API获取私有仓库的工作流状态，只需在URL中加入PAT参数，示例：

![pytest](https://img.shields.io/github/actions/workflow/status/preritdas/wooster-trading-systems/pytest.yml?branch=master&token=YOUR_PERSONAL_ACCESS_TOKEN)
![firebase](https://img.shields.io/github/actions/workflow/status/preritdas/wooster-trading-systems/firebase-hosting-merge.yml?branch=master&token=YOUR_PERSONAL_ACCESS_TOKEN)
![pages-build-deployment](https://img.shields.io/github/actions/workflow/status/preritdas/wooster-trading-systems/pages/pages-build-deployment.yml?branch=master&token=YOUR_PERSONAL_ACCESS_TOKEN)

这种方式可以让所有徽章样式保持一致，同时解决权限问题。

方案三：将仓库设为公开（可选） #

如果仓库内容允许公开，将仓库设为公开后，工作流徽章无需权限即可直接加载，这是最简单的解决方式，但仅适用于无隐私需求的场景。

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