关联远程分支需同时满足远程仓库存在、本地分支已命名、上游跟踪已设置三个条件；“remote origin already exists”是保护机制提示，应使用git remote set-url更新而非重加；首次push必须带-u参数设置upstream，否则报“no upstream branch”；远程新增分支需先git fetch再git branch -a查看；分支名不一致时须先统一再推送，历史差异需用--allow-unrelated-histories处理。
关联远程分支不是执行一条命令就能完事的事，它必须同时满足“远程仓库存在”“本地分支已命名”“上游跟踪已设置”三个条件，缺一不可。
git remote add origin 失败：remote origin already exists 是正常提示，不是错误
这个报错只说明本地已有名为 origin 的远程配置，Git 拒绝重复添加是保护机制。别删了重加，直接更新地址更安全：
- 先用
git remote -v确认当前远程名和 URL - 若要换地址，运行
git remote set-url origin https://gitee.com/user/new-repo.git - 若确定旧远程完全废弃，再用
git remote remove origin清理
注意：git remote add 从不覆盖，只拒绝执行；而 set-url 是唯一推荐的更新方式。
git push 报 fatal: The current branch main has no upstream branch
这是最常被误认为“关联失败”的问题——其实远程仓库和 origin 都已存在，只是本地分支没告诉 Git “该推到哪去”。根本原因在于缺少 upstream 跟踪配置：
- 首次推送必须带
-u参数：git push -u origin main - 如果已经推过但漏了
-u，补上：git branch --set-upstream-to=origin/main main - 检查是否生效：
git branch -vv输出中当前分支后应有[origin/main]
别用弃用的 --set-upstream，也别乱设 push.default 为 current，否则多人协作时可能误推到错误远程分支。
Conventional Git
下载
Conventional Commits v1.0.0 分支、工作树命名及提交信息规范，适用于 GitHub 与 GitLab 项目，用于创建分支和命名工作树等场景。
远程有新分支，本地 git branch -a 看不到
这是因为 git branch -a 显示的是本地缓存的远程分支快照，不是实时状态。远程新增分支不会自动同步到你的本地记录里：
- 先运行
git fetch origin（或git fetch），把远程所有分支信息拉到本地 - 再执行
git branch -a，就能看到remotes/origin/feature/login这类条目 - 想在本地创建并切换过去：
git checkout -b feature/login origin/feature/login
VSCode 点“发布到 GitHub”卡住、提示 “no upstream configured”，往往就是这个原因：它默认找 origin/main，但远程只有 master，且你还没 fetch 过。
远程默认分支是 master，但本地是 main：别硬 push
Git 默认不自动转换分支名，git push origin main 不会自动映射到远程的 master。强行推送会失败，或触发非预期行为：
- 先统一命名：
git branch -M main（如果本地是master）或git branch -M master（如果远程是master） - 再推送并设上游：
git push -u origin main（把main换成你最终确定的分支名） - 如果远程已有提交（比如带 README 初始化），而你本地还没
pull就 push，会提示non-fast-forward；此时先git pull origin main --allow-unrelated-histories再 push
真正容易被忽略的是：远程仓库刚创建时的初始状态（是否有 README、.gitignore）会直接影响第一次 push 是否成功——问题通常不出在“怎么关联”，而出在“历史没对齐”。
