应先运行 git remote -v 确认 origin 是否已存在，若仅需更换地址则用 git remote set-url origin ，而非重复 add；确需删除时再执行 git remote remove origin，避免破坏现有推送配置。
git remote add origin 报 fatal: remote origin already exists 怎么办
这不是错误，是 Git 在防止你重复添加同名远程地址。直接删掉重加反而容易断掉已有推送配置。
- 先运行
git remote -v确认当前 remote 名（可能是origin，也可能是upstream或其他） - 如果只是换地址，用
git remote set-url origin https://gitee.com/user/repo.git替换，别用add - 如果真要清理旧 remote，再执行
git remote remove origin，但务必确认它没被其他分支或 CI/CD 工具依赖
第一次 git push 被拒绝：non-fast-forward 是什么情况
说明远程仓库已有提交（比如你创建时勾选了 README），而本地还没拉取就直接 push。Git 默认拒绝覆盖历史。
- 先执行
git pull origin main --allow-unrelated-histories（把main换成你实际的远程默认分支名，如master） - 如果有冲突，手动解决后
git add . && git commit -m "merge remote init" - 再执行
git push -u origin main（-u只需首次加，后续可直接git push） - 别用
git push --force，尤其在多人协作项目里——它会抹掉别人的历史
VSCode “发布到 GitHub” 卡住或报 no upstream configured
VSCode 的“发布”按钮本质就是调用 git push -u origin main，但它不会自动适配分支名差异。
- 终端运行
git branch看当前本地分支名（比如是main还是master） - 再运行
git ls-remote --heads origin查远程有哪些分支（注意看输出里是refs/heads/main还是refs/heads/master） - 如果不一致，用
git branch -M main或git branch -M master重命名本地分支 - 然后手动执行
git push -u origin main（把main换成你对齐后的分支名）
远程分支名和本地分支名不一致时怎么推
分支名不匹配不是语法错误，而是逻辑断连——Git 不会自动帮你映射，也不会报错提示“分支不存在”，只会静默失败或提示 rejected。
- 本地分支叫
dev，远程想推到feature/login？用git push origin dev:feature/login - 想让本地
dev跟踪远程feature/login？用git branch --set-upstream-to=origin/feature/login dev - 后续
git push和git pull就能自动对应，不用每次都写完整 refspec -
git branch -vv可验证跟踪关系是否生效（看输出里是否有[origin/xxx]）
