使用Github Action部署站点遇异常：Workflow执行成功且gh-page分支已更新，但无法查看站点链接

针对你遇到的两个问题，我整理了几个最常见的排查方向，你可以逐一验证：

问题1：部署流程启动后GitHub未显示站点部署目标链接 #

• 检查Pages部署源配置：进入仓库的Settings → Pages，确认「Source」区域已正确选择gh-pages分支（以及对应的根目录或子目录，比如/root）。如果这里未配置，哪怕Workflow成功更新了分支，GitHub也不会自动生成部署链接。
• 等待部署初始化时间：首次部署时，GitHub可能需要3-5分钟完成站点生成和链接关联，不要着急刷新，过几分钟再回到Pages页面查看。
• 确认Workflow部署动作：如果你的Workflow使用了自定义脚本而非官方的actions/deploy-pages动作，可能无法触发GitHub的Pages部署检测逻辑，导致链接不显示。建议替换为官方部署动作，确保流程和GitHub Pages系统正确联动。

问题2：Workflow成功、gh-pages分支更新但无法访问站点 #

• 验证Pages部署状态：进入Settings → Pages，下拉查看「Deployment history」，确认最近的部署状态是「Active」。有时候Workflow执行成功，但Pages实际部署可能因文件结构错误（比如缺失index.html）而失败。
• 检查gh-pages分支内容：打开gh-pages分支，确认静态站点文件（如index.html、CSS/JS资源）都在正确的目录下（通常是根目录）。如果Workflow把输出文件放到了子目录，需要在Pages配置的「Source」里选择对应的子路径。
• 自定义域名配置排查：如果绑定了自定义域名，检查Settings → Pages里的「Custom domain」是否正确，同时确认DNS解析的CNAME记录已指向<你的用户名>.github.io。GitHub会自动检测域名配置，若有错误会在Pages页面给出提示。
• 清除浏览器缓存：浏览器可能缓存了旧的无效页面，尝试用Ctrl+Shift+R（Windows/Linux）或Cmd+Shift+R（Mac）强制刷新，或者用无痕模式访问站点。
• 私有仓库权限验证：如果你的仓库是私有仓库，需要确保你拥有GitHub Pro/Team计划（免费版私有仓库无法启用Pages功能），且当前账号有权限访问该仓库的Pages站点。

内容的提问来源于stack exchange，提问作者Z-Buffer