Visual Studio 2019菜单同步GitHub时反复出现代码推送被拒绝问题咨询
报错核心产生原因
你作为仓库唯一使用者仍触发该推送拒绝报错,和其他协作者操作无关,是三类问题叠加导致:
- 首次报错的根因未被真正解决:第一次推送被拒时,远程仓库自带的初始化提交(比如GitHub创建私有仓库时勾选生成README、.gitignore所产生的提交)从未被同步到本地。当时通过重命名仓库临时恢复推送,只是让VS重置了本地的远程连接映射,靠首次关联的快速通道绕过了提交历史分叉的校验,并没有把本地缺失的远程提交合并到本地。
- VS2019内置Git的逻辑缺陷:仓库重命名操作会让VS缓存的远程仓库URL和实际地址出现微小偏差,当缓存失效重新校验提交历史时,就会检测到本地分支指针没有覆盖远程端的所有提交记录,哪怕这些提交是你自己在GitHub网页端生成的、没有经过本地推送的内容,也会直接拦截推送,抛出“远程包含本地不存在的内容”的提示。
- 默认配置缺失:VS内置的同步按钮默认不会在推送前先拉取远程最新内容,一旦本地和远程的提交历史出现哪怕1个提交的偏移,就会触发推送拒绝规则。
零命令行分步解决方法(全在VS2019内操作)
- 修正远程连接映射
打开VS2019的「Git设置」面板,定位到「远程仓库」配置项,找到当前绑定的origin条目,重新输入你GitHub上对应私有仓库的最新完整URL,保存配置后刷新远程列表,确保VS读取到的是当前真实的远程仓库地址。 - 强制拉取合并分叉提交
不要直接点顶部的「同步」按钮,在分支列表中找到你的本地主分支,右键选择「拉取」选项,待VS检测到本地和远程的提交分叉后,按照提示创建合并提交,确认没有代码冲突后完成本地提交。这一步会把本地一直缺失的远程初始化提交正式合并到本地历史中,从根上消除提交分叉。 - 开启长效防错配置
在VS的Git全局设置中,打开「推送前自动拉取远程变更」的开关,后续每次执行同步操作时,VS会先完成远程内容的拉取校验,再执行推送流程,避免因为分支指针偏移触发拒绝报错。
注意:不要为了绕过校验使用强制推送选项,对于单人私有仓库来说,强制推送会直接覆盖远程端本地缺失的初始化提交,虽然能临时解决报错,但后续仍会因为提交历史不匹配重复触发问题。
内容的提问来源于stack exchange,提问作者Madison320
相关产品推荐
相关产品推荐

