git remote 关联与管理远程仓库（add/set-url/rename/remove）
本地仓库怎么关联 GitHub/GitLab 远程？怎么查看、改名、更换远程地址？本文讲清 git remote 全家桶：add、-v、set-url、rename、remove 与多远程。
场景：本地代码建好了，想推到 GitHub/GitLab，或想换远程地址。这些都要通过 git remote 来管理"远程仓库"的关联。
查看已关联的远程
git remote # 列出远程名(默认 origin)
git remote -v # 显示远程名和 URL(常用)-v 会显示 fetch(拉取)和 push(推送)地址。
关联新远程
git remote add origin https://github.com/用户/仓库.gitorigin 是约定的主远程名。之后就能 git push origin main。
首次推送并关联
git push -u origin main-u 建立本地 main 与远程 origin/main 的跟踪关系，后续直接 git push 即可。
更换远程地址
# 换掉现有 origin 的地址(HTTPS 换 SSH、换账号等)
git remote set-url origin git@github.com:用户/仓库.git
# 验证
git remote -v比删除重建更干净，保留其他设置。
重命名远程
git remote rename origin github把 origin 改名为 github。
删除远程
git remote remove origin
# 或
git remote rm origin删除后该远程的所有跟踪分支引用也会清理。
添加多个远程(同时同步多平台)
git remote add github https://github.com/用户/仓库.git
git remote add gitee https://gitee.com/用户/仓库.git
git push github main # 推 GitHub
git push gitee main # 推 Gitee一个本地仓库可同步到多个平台。
查看远程的详细分支信息
git remote show origin会列出远程分支、本地跟踪关系、是否过期等。
常见问题
- push 报 remote origin already exists：说明已有 origin，用 set-url 改地址或 rename 后再 add。
- 换地址后 push 认证失败：确认新地址协议正确(HTTPS 配 token、SSH 配公钥)。
- 看不到远程分支：
git fetch拉取远程引用后git branch -r查看。
一句话速记
git remote add 关联、set-url 换地址、rename 改名、remove 删除；一个仓库可配多个远程。
?
常见问题 FAQ
怎么把本地仓库关联到 GitHub 的远程仓库?
先在 GitHub 建好空仓库，然后本地执行 git remote add origin 仓库地址，再用 git push -u origin 分支名 首次推送。
换了一个远程地址(比如换了 GitHub 账号)怎么改?
用 git remote set-url origin 新地址 更新现有 origin 的地址，不必删除重建。git remote -v 可确认当前地址。
origin 这个名称可以改吗?
可以。origin 只是默认的远程名，可用 git remote rename origin 新名 改名。日常习惯保留 origin 作为主远程即可。
能同时关联 GitHub 和 Gitee 两个远程吗?
能。用 git remote add gitee 地址 添加第二个远程名 gitee，之后 git push gitee 主分支 可推送到它，实现一个本地代码同步多平台。