Git Remote
最后更新
git remote 管理仓库为远程仓库起的简称,最常见的是指向你 GitHub 仓库的 origin。刚开始时用它添加远程仓库,之后用它列出已有的远程仓库、重命名或删除它们,以及修改远程仓库的地址(例如从 HTTPS 换成 SSH)。
在终端在线编辑器中试试这些命令:浏览器里就是真正的 shell,无需安装。
语法
| 命令 | 作用 |
|---|---|
git remote -v | 列出远程仓库及其地址 |
git remote add origin <url> | 添加一个名为 origin 的远程仓库 |
git remote set-url origin <url> | 修改远程仓库的地址 |
git remote rename origin upstream | 重命名远程仓库 |
git remote remove origin | 删除远程仓库 |
git remote show origin | 显示远程仓库的详细信息 |
常见用法
| 目标 | 命令 |
|---|---|
| 把新仓库连接到 GitHub | git remote add origin <url> |
| 从 HTTPS 换成 SSH | git remote set-url origin git@github.com:... |
| 查看 origin 指向哪里 | git remote -v |
完整示例
| 步骤 | 命令 | 结果 |
|---|---|---|
| 1 | git remote add origin https://github.com/you/app.git | 以 origin 为名登记这个 GitHub 仓库 |
| 2 | git remote -v | 列出 origin 及其 fetch 和 push 地址 |
| 3 | git push -u origin main | 上传 main,并让它跟踪 origin/main |
git remote 常见问题
Git 远程仓库是什么?
远程仓库是对托管在别处的仓库的一个命名引用,通常位于 GitHub、GitLab 或某台服务器上。默认名称是
origin。git push、git pull 和 git fetch 都是和远程仓库同步。git remote 就是用来管理这些命名引用的命令。怎么添加远程仓库?
运行
git remote add origin <url>,填入仓库的地址。这会以 origin 为名把本地仓库和远程仓库关联起来。之后就可以用 git push -u origin main 推送。如果 origin 已经被占用,换一个名字(例如 upstream)。怎么修改远程仓库的地址?
使用
git remote set-url origin <new-url>。想把仓库从 HTTPS 地址换成 SSH 地址(或者仓库改名后更新地址),就用这个命令,不需要先删除再重新添加远程仓库。用 git remote -v 确认修改结果。怎么查看我的远程仓库?
运行
git remote -v,列出每个远程仓库及其 fetch 和 push 地址。要查看某个远程仓库的详细信息(包括它跟踪的分支),使用 git remote show origin。git remote add origin 是做什么的?
它在仓库的配置中以
origin 为名保存一个地址。此时还不会上传或下载任何东西:这个命令只是创建一个名字,以后你就可以输入 git push origin main,而不用写完整的地址。如果 origin 已经存在,Git 会拒绝并提示“remote origin already exists”;这时用 git remote set-url origin <url> 把它指向别的地址。origin 和 upstream 有什么区别?
两者都只是约定俗成的名字。
origin 是你克隆来源或第一次推送的远程仓库,通常是你自己的副本。当你 fork 一个项目时,常常会用 git remote add upstream <url> 把原始仓库添加为第二个远程仓库,命名为 upstream,这样就能获取它的更新,同时推送到你的 fork。怎么从远程仓库获取某个分支?
可以在线练习吗?
可以。打开终端在线编辑器,就能在浏览器里的真实 shell 中运行
git remote,无需安装。Coddy 的免费互动 Git 课程也会一步步教你连接远程仓库。