使用gh-pages部署React应用时卡在分支创建环节

排查与修复步骤 #

1. 检查.gitignore规则 #

虽然提示的是node_modules被忽略，但需确保.gitignore没有误拦截gh-pages所需文件：

• 打开项目根目录的.gitignore，确认未包含build/目录（若有则注释该行）
• 确保未忽略.git/相关目录，gh-pages依赖git仓库操作

2. 清理本地异常分支与暂存区 #

本地gh-pages分支可能存在状态异常，先清理再重试：

# 删除本地gh-pages分支
git branch -D gh-pages
# 清空src文件的暂存状态
git reset HEAD --src
# 重新执行部署
npm run deploy

3. 明确指定远程仓库地址 #

若本地git远程配置不明确，可在deploy脚本中添加远程仓库参数：
修改package.json的scripts字段：

"deploy": "gh-pages -d build -r git@github.com:你的用户名/你的仓库名.git"

替换为你的实际远程仓库地址后，重新执行npm run deploy

4. 确保本地仓库已关联远程且有提交 #

• 检查远程关联状态：git remote -v，若无关联则执行git remote add origin git@github.com:你的用户名/你的仓库名.git
• 确保主分支（main/master）有至少一次提交：无提交则先执行git add . && git commit -m "initial commit"，再部署

5. 重新安装gh-pages依赖 #

依赖可能存在缓存或兼容问题，重新安装：

npm uninstall gh-pages
npm install gh-pages@^5.0.0 --save-dev

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