使用gh-pages部署GitHub用户页面时遇master分支已存在错误

问题原因 #

你用gh-pages -b master -d build报错，是因为用户级托管仓库本身就以master（或main）作为主分支，gh-pages工具尝试创建该分支时触发了冲突。

直接可行的解决方案 #

用户级GitHub Pages不需要依赖gh-pages的分支指定功能，直接把build产物推到仓库主分支即可：

• 先执行构建：npm run build
• 进入build目录：cd build
• 初始化git（若未初始化）：git init
• 提交产物：

  git add .
  git commit -m "deploy user page"
  

• 关联远程仓库（如果没关联过）：git remote add origin https://github.com/你的用户名/你的用户名.github.io.git
• 强制推送到主分支（如果主分支是main就替换成main）：git push -f origin master

若坚持用gh-pages工具 #

可以加--clean参数清理缓存，强制推送更新：
修改package.json里的deploy脚本为：

"deploy": "gh-pages --clean -b master -d build"

然后重新执行npm run deploy

前置检查 #

确保你的仓库名称是你的用户名.github.io，且package.json中已配置：

"homepage": "https://你的用户名.github.io"

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