Skip to content

远程仓库

Git 基础

一句话解释

远程（remote）是托管在服务器上的仓库副本，常指 GitHub / GitLab 上的那个版本，默认命名为 origin。

用大白话说

远程（remote）是相对本地仓库而言的——指托管在服务器（如 GitHub、GitLab、Gitee）上的那份仓库。本地和远程之间通过 push / pull 同步。

一个本地仓库可以配多个远程。克隆时 Git 自动把来源远程命名为 origin，这是约定俗成的默认名。你也可以添加其他远程：

git remote -v                    # 查看所有远程
git remote add upstream <地址>    # 添加一个叫 upstream 的远程
git push origin main             # 推到 origin 的 main 分支
git pull upstream main           # 从 upstream 拉 main 分支

常见场景：你 fork 了一个开源项目，clone 自己 fork 的仓库（origin 指向你的 fork），再 add 原项目为 upstream，这样能从原项目拉最新改动，改完推回自己的 fork 发 PR。

示例

bash
git remote -v                  # 查看远程列表
# origin  https://github.com/you/repo.git (fetch)
# origin  https://github.com/you/repo.git (push)

git remote add upstream https://github.com/original/repo.git
git pull upstream main         # 从原项目拉最新改动

git remote -v 列出所有远程，git remote add 添加新远程。origin 通常是自己的 fork，upstream 是原项目。

工作原理

  1. git clone 时自动创建名为 origin 的远程
  2. git remote add 名字 地址 添加更多远程
  3. git push 远程名 分支 把本地提交推到该远程
  4. git pull 远程名 分支 从该远程拉取最新改动

常见混淆

  • 容易混淆的对象: origin

    关键区别: origin 是远程的默认名字（一个标签），远程是服务器上的那份仓库。可以有多个远程，origin 只是其中一个的约定俗成名字。

相关术语

相关资源

相关课程

学习基础知识

通过结构化课程深入理解这个主题。

查看课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表