执行npm run deploy部署gh-pages时触发git bad object报错如何解决

报错核心是本地仓库的origin/main远程跟踪分支引用及对应日志损坏，导致git自动执行gc打包操作时找不到关联的commit对象，中断部署流程，常见触发场景包括：

• git操作执行过程中终端/VS Code意外崩溃、进程被强制终止，导致引用文件写入截断
• 本地磁盘坏道、安全软件误扫描篡改了.git目录下的引用文件
• 之前执行pull/push操作时网络异常中断，远程对象拉取不完整，残留无效引用
• gh-pages部署脚本执行时会调用git底层操作引用、做对象打包，损坏的引用会直接让部署流程抛错终止

按以下步骤顺序操作即可：

1. 清理本地损坏的引用文件
   在VS Code打开的项目终端中执行对应命令删除损坏文件：
   Mac/Linux系统执行：

   rm -f .git/refs/remotes/origin/main
   rm -f .git/logs/refs/remotes/origin/main
   

   Windows PowerShell环境执行：

   Remove-Item -Force .git/refs/remotes/origin/main
   Remove-Item -Force .git/logs/refs/remotes/origin/main
   

2. 修复本地git对象库、重新同步远程引用
   依次执行以下命令清理无效对象、拉取正确的远程分支信息：

   git gc --prune=now
   git fetch origin --prune
   

3. 验证修复效果
   执行git branch -a，确认输出列表中能正常显示remotes/origin/main且无报错；再执行git status确认工作区状态展示正常，无引用类错误提示。
4. 恢复部署流程
   上述校验通过后，直接执行npm run deploy即可正常完成gh-pages部署。

兜底方案：如果以上操作执行后仍存在报错，说明本地.git目录损坏范围较大，可将项目中除.git文件夹外的所有业务文件备份到其他位置，重新克隆远程仓库到本地，将备份的业务文件复制到新克隆的仓库目录中，再重新执行提交、部署操作即可彻底解决问题。

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