master分支因环境保护规则无法部署至GitHub Pages的解决方法

1. 调整工作流的触发分支 #

你复制的官方starter workflow默认监听main分支的推送/PR，现在要从master分支部署，得把工作流文件里的on区块改成触发master分支：

on:
  push:
    branches: [ "master" ]
  pull_request:
    branches: [ "master" ]

2. 配置GitHub Pages的环境允许列表 #

进入仓库的Settings → Pages页面：

• 确认部署来源仍为gh-pages分支（这个无需修改）
• 如果开启了环境保护规则，需要把master分支添加到允许部署的分支名单里；要是不需要环境保护，直接关闭规则即可

3. 确认工作流的部署配置 #

检查工作流里的部署动作（比如actions/deploy-pages），保证目标分支是gh-pages，同时保留你修改的上传路径./web/root，示例代码片段：

- name: Deploy to GitHub Pages
  uses: actions/deploy-pages@v2
  with:
    folder: ./web/root

4. 检查权限设置 #

工作流文件里的permissions区块要确保有部署Pages的权限：

permissions:
  contents: read
  pages: write
  id-token: write

内容的提问来源于stack exchange，提问作者Tomáš Zato