如果你是通过:
git clone从 GitHub 获取项目的,那么远程仓库通常已经自动配置好了。
但如果你的项目是先在本地使用:
git init创建的,那么 Git 还不知道这个项目应该连接到哪个 GitHub Repository。这时就需要手动添加远程仓库。
在 GitHub 创建 Repository
假设你已经有一个本地项目:
git-demo并且这个项目已经执行过:
git init接下来,可以在 GitHub 上创建一个新的 Repository,例如:
git-demo创建完成后,GitHub 会提供一个 Repository 地址,通常类似:
https://github.com/username/git-demo.git这个地址就是本地 Git 用来访问远程仓库的位置。
使用 git remote add
在本地项目目录中运行:
git remote add origin https://github.com/username/git-demo.git这条命令可以拆开理解:
git remote add → 添加一个远程仓库 → origin → 给这个远程仓库取名为 origin → https://... → GitHub Repository 地址
执行成功后,本地 Git 就知道:
origin = 这个 GitHub Repository查看当前远程仓库
可以运行:
git remote如果配置成功,通常会看到:
origin如果想同时查看远程仓库的地址,可以使用:
git remote -v输出可能类似:
origin https://github.com/username/git-demo.git (fetch)
origin https://github.com/username/git-demo.git (push)这里的 fetch 表示从远程获取内容时使用的地址,push 表示上传内容时使用的地址。对于基础使用来说,它们通常是同一个 URL。
如果已经使用 git clone
如果项目是通过:
git clone https://github.com/username/git-demo.git获取的,那么 Git 通常已经自动帮你完成了:
origin → GitHub Repository
所以不需要再次执行:
git remote add origin ...你可以直接运行:
git remote -v确认配置。
知识测验
git remote add origin URL 做了什么?
HTTPS 和 SSH
GitHub Repository 地址常见有两种形式。
HTTPS:
https://github.com/username/git-demo.gitSSH:
[email protected]:username/git-demo.git两种方式都可以使用。
对于刚开始学习 Git 的人来说,HTTPS 通常更容易理解。SSH 需要额外配置 SSH Key,适合后面再学习。
本教程基础部分默认使用 HTTPS。
如果远程地址配置错了
如果你发现 origin 指向了错误的地址,可以使用:
git remote set-url origin https://github.com/username/correct-repo.git然后再次检查:
git remote -v确认地址已经正确。
练习
本地仓库需要连接到 https://github.com/example/notes.git。写出添加 origin、检查 Fetch/Push 地址,以及地址写错后修正它的命令。