嘿，我来帮你一步步理清GitHub Pages的部署流程，看起来你在分支推送和配置上有点小误区，咱们逐个解决：

一、正确推送gh-pages分支到远程 #

你之前错误地把gh-pages分支的内容推到了master分支，这就是GitHub只显示master的核心原因。按以下步骤修正：

• 先确认本地分支状态，确保gh-pages分支存在：

  git branch -a
  

• 切换到gh-pages分支：

  git checkout gh-pages
  

• 把项目的静态文件（比如HTML/CSS/JS，或者框架build后的产物）放到这个分支的根目录，记得忽略不需要的文件（比如node_modules），可以在.gitignore里添加对应规则。
• 推送gh-pages分支到远程仓库：

  git push origin gh-pages
  

  这一步是关键——要推的是gh-pages分支，而非master。

二、配置GitHub Pages源 #

推送完成后，去GitHub仓库后台设置Pages：

• 打开仓库的「Settings」页面，在左侧菜单找到「Pages」选项
• 在「Source」区域，选择分支为gh-pages，目录选/root（如果你的静态文件放在docs文件夹里就选/docs），然后点击「Save」
• 等待1-2分钟，GitHub会生成你的Pages访问链接，格式一般是https://你的用户名.github.io/仓库名称/

三、把链接添加到README #

现在把生成的链接加到README里：

• 切换回主分支（比如master/main）：

  git checkout master
  

• 编辑README文件，添加类似这样的内容：

  🌐 在线预览：https://你的用户名.github.io/仓库名称/
  

• 提交并推送修改：

  git add README.md
  git commit -m "Add GitHub Pages preview link"
  git push origin master
  

四、关于新仓库无法推送的问题 #

如果是新创建的GitHub仓库，需要先把本地仓库和远程仓库关联：

• 在GitHub创建好新仓库后，执行以下命令关联远程：

  git remote add origin https://github.com/你的用户名/新仓库名称.git
  

• 之后再推送gh-pages分支：

  git push origin gh-pages
  

小提醒 #

• 确保gh-pages分支里有可访问的index.html文件，否则GitHub Pages会显示404
• 如果是React/Vue这类框架项目，记得先执行npm run build，把build文件夹里的所有内容复制到gh-pages分支的根目录再推送

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