GitHub Pages自定义工作流部署后未更新，仅显示README.md

核心排查点与解决步骤 #

• 检查gh-pages分支的文件结构
  确保编译后的静态文件（来自public目录）直接放在gh-pages分支的根目录，而非嵌套在public文件夹内。如果部署动作把整个public目录推送到分支，GitHub Pages找不到根目录的index.html，就会默认展示README。比如使用peaceiris/actions-gh-pages时，要确认配置里的publish_dir: ./public，这个参数会把public内的所有内容推送到分支根目录。

• 确认编译产物包含index.html
  你的index.py脚本必须生成index.html文件到public目录的根路径。如果生成的入口文件命名错误或放在子目录，GitHub Pages无法识别，就会 fallback 显示README。检查编译逻辑，确保最终输出的静态文件根目录存在index.html。

• 重新验证Pages源配置
  再次确认仓库的GitHub Pages设置里，源选择的是GitHub Actions，而非gh-pages分支的特定路径。设置完成后，手动重新运行一次工作流，确保部署动作重新推送最新内容。

• 清除Pages缓存
  若以上都没问题，可能是缓存导致旧内容残留。可以删除gh-pages分支后重新运行工作流，或者在仓库的Pages设置页点击「重新部署」按钮（若有该选项）强制刷新。

内容的提问来源于stack exchange，提问作者Chris Ze Third