本地分支推不上去，大概率是未关联远程仓库或分支名不匹配；应先用git remote -v确认远程配置，再用git branch -vv检查追踪关系，确保分支名一致（如github默认main、gitee多用master），必要时用git push -u origin 首次推送建立关联。
本地分支推不上去，大概率是没关联远程仓库，或分支名不匹配，而不是网络或权限问题。
git remote add origin 失败：remote origin already exists
执行 git remote add origin <url></url> 报错，说明本地仓库已经配置过名为 origin 的远程地址。
- 先用
git remote -v查看当前配置，确认是否真要覆盖 - 如果要换地址，直接删掉再加：
git remote remove origin→git remote add origin <new-url></new-url> - 如果只是想改地址，更稳妥的是：
git remote set-url origin <new-url></new-url> - 别重复执行
git init—— 已有.git目录时再 init 不会报错，但可能重置部分配置
git push origin main 拒绝推送：non-fast-forward 或 refused to update refs
常见于远程分支已有提交（比如带 README.md），而本地是全新初始化的仓库，两者历史完全无关。
- 必须先拉取远程内容：
git pull origin main --allow-unrelated-histories（注意分支名可能是main或master） - 拉完后，
git status通常会显示 “Your branch is ahead of 'origin/main' by X commits”，这时才能git push origin main - 如果远程分支名是
main，但本地当前分支叫master，要么重命名本地分支：git branch -M main，要么显式推送：git push origin master:main - 别跳过
--allow-unrelated-histories直接git push—— Git 默认拒绝这种合并，不是 bug，是保护机制
git push -u origin main 后，后续 git push 报错“no upstream configured”
说明 -u 没生效，或你切换到了别的分支。
- 检查当前分支是否真设了上游：
git branch -vv，输出里应有[origin/main]这样的标记 - 如果没看到，重新执行：
git push -u origin main（确保在main分支下） - 如果本地分支名和远程不一致（如本地叫
dev，远程叫develop），得写全：git push -u origin dev:develop -
-u只对当前分支生效，其他分支要单独设置
最容易被忽略的是分支名的实际值——GitHub 新建仓库默认用 main，Gitee 仍多用 master，GitLab 可自定义。不查 git remote show origin 或网页端仓库设置页，光靠经验猜，十次有八次推错地方。
