GitHub Actions部署GitHub Pages提示需GITHUB_TOKEN或GH_PAT如何解决

问题根因 #

你工作流配置的env段中，环境变量键名多了多余的$前缀，部署action无法匹配到预期的GITHUB_TOKEN变量，因此抛出缺少令牌的错误。

修正后的部署配置 #

- name: Deploy
  uses: crazy-max/ghaction-github-pages@v2
  with:
    target_branch: master
    build_dir: build
  env:
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

可选校验项 #

如果修改后仍触发报错，可再确认两点：

• 仓库工作流权限配置保持当前的读写权限即可，自动生成的GITHUB_TOKEN无需额外配置就可以支持GitHub Pages部署
• 不需要额外创建个人访问令牌（GH_PAT），避免增加不必要的权限泄露风险

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