git remote 命令详解

1. 使用场景
2. 推送代码流水线
3. 添加远程库配置
4. 修改远程库配置
5. 删除远程库配置
6. 重命名远程库配置
7. 推送到多个仓库
8. 查看远程库配置
9. 查看远程库信息以及和本地库的关系

1. 使用场景

---

看完本文内容可解决以下问题:

1、本地代码需要上传到远程仓库上时
2、本地已有仓库，需要将本地仓库推送到远程仓库上时
3、本地已有仓库，并且已关联远程仓库，需要更改关联的远程库时

2. 推送代码流水线

---

1. # 第一步: 创建本地库并完成初始提交，也就是让本地库有提交记录
2. git init
3. git add .
4. git commit -m "first commit"
5. # 第二步: 添加一个远程仓库配置
6. git remote add origin https://gitee.com/holyking/test-1.git
7. # 第三步: 设置上游分支，并且使用远程名称推送到远程库
8. git push -u origin master

3. 添加远程库配置

---

首次将代码推送到远程仓库出现以下提示:

1. # 没有配置推送目标
2. fatal: No configured push destination.
3. # 从命令行指定 URL，或使用配置远程存储库
4. Either specify the URL from the command-line or configure a remote repository using
5. # 然后使用远程名称推送
6. and then push using the remote name

从命令行指定 URL

1. # 命令格式
2. git push <url> <branch>
3. # 使用示例
4. git push [email protected]:holyking/test-1.git master

先配置一个远程存储库，然后使用远程名称推送（其实就是给远程库 url 起了一个比较短的名称，然后使用短名称推送）

1. # 命令格式
2. git remote add <name> <url>
3. git push <name> <branch>
4. # 使用示例
5. git remote add origin [email protected]:holyking/test-1.git
6. git push origin master

4. 修改远程库配置

---

如果本地仓库已经关联过远程仓库，使用 git remote add 直接关联新的远程库时会报错

1. fatal: remote origin already exists.
2. 

解决方案1: 先删除以前的远程仓库关联关系，再关联新的远程仓库

1. git remote rm origin
3. git remote add origin https://gitee.com/holyking/test-3.git
4. 

解决方案2: 使用 git remote set-url origin 直接修改关联的远程仓库

1. # 使用前提: 远程名称 origin 已存在
2. git remote set-url origin https://gitee.com/holyking/test-3.git

修改关联的远程仓库总结:

1. # 方案1: 先删除远程库配置，再重新添加
2. git remote rm <name>
3. git remote add <name> <url>
5. # 方案2: 使用 set-url 直接修改
6. git remote set-url <name> <url>

5. 删除远程库配置

---

删除远程库配置

1. # 命令格式
2. git remote remove <name>
3. # 使用示例
4. git remote remove origin

经测试 rm、remove 的作用是一样的，所以也可以使用下面用法

1. git remote rm <name>

6. 重命名远程库配置

---

1. # 命令格式
2. git remote rename <old> <new>
3. # 使用示例
4. git remote rename origin liang

7. 推送到多个仓库

---

添加远程库配置（我们要将代码推送到 gitee 和 github 两个平台）

1. # gitee
2. git remote add gitee [email protected]:holyking/test-1.git
3. # github
4. git remote add github [email protected]:shinyboys/test-2.git

将代码推送 gitee 和 github

1. git push gitee master && git push github master

推送到远程库时，因为命令有点长，我们可以定义一个系统配置别名，进而简化推送命令

1. # mac 用户可以在 ~/.zshrc 文件中增加以下配置，通过别名 gp 推送
2. alias gp="git push gitee master && git push github master"

8. 查看远程库配置

---

不带参数时，就是列出已存在的远程分支

1. git remote

-v，--verbose 查看所有远程仓库配置

1. git remote -v

9. 查看远程库信息以及和本地库的关系

---

这个命令会联网去查询远程库信息，并且会列出和本地库的关系

1. # 命令格式
2. git remote show <name>
3. # 使用示例
4. git remote show origin