（Git/Github笔记）GUI工具TortoiseGit基本使用+Git本机版本库上传至Github远程版本库

目录

• 1.前言
• 2.准备工程项目
  •  （1）创建AndroidStudio工程项目
• 3.初始化工程项目为Git本机版本库
• 4.提交工程项目到Git本机版本库
  • （1）Add添加文件
  • （2）Commit提交文件
• 5.Git本机版本库Push推送Github远程仓库​​​​​​​​​​​​​​​​​​​
  • ​​​​​​​​​​​​​​（1）注册Github账户
  • （2）创建Github远程版本库
  • （3）获取Github版本库URL地址
  • （4）pull发生错误：refusing to merge unrelated histories
  • （5）解决pull错误：强制允许不相关历史分支合并
    • ​​​​​​​​​​​​​​步骤一：git remote -v
    • 步骤二：Manage设置URL地址
    • 步骤三：再次git remote -v
    • 步骤四：强制​​​​​​​合并​​​​​​​分支git pull origin master --allow-unrelated-histories
  • （6）TortoiseGit中再次使用pull获取分支建立版本库连接关系
  • （7）push推送Git本机版本库至Gihub远程版本库
• 6.Github检测Push推送成功的工程项目
• 7.总结

---

1.前言

        本章介绍使用TortoiseGit客户端的把Git本机版本库管理的工程项目推送Github远程版本库上。

        本章用到Git Bash命令行操作Github，因此需要提前配置Git本机客户端与Github服务器的SSH，使得密钥对匹配，使用Git Bash生成ssh-rsa及Github服务器中配置ssh key的教程，传送门链接：

        （Git/Github笔记）Git Bash生成ssh-rsa

          CSDN链接：https://blog.csdn.net/qq_39038178/article/details/119433916

        另外推荐：GUI工具 TortoiseGit 2.12.0 安装和配置+OpenSSH配置Github​​​​​​​，传送门链接： 

        （Git/Github笔记）GUI工具 TortoiseGit 2.12.0 安装和配置+OpenSSH配置Github

          CSDN链接：https://blog.csdn.net/qq_39038178/article/details/119363867

---

2.准备工程项目

        这里我使用AndroidStudio创建项目实践Git使用，用其它IDE工具创建项目是可以的，例如：IDEA、Pycharm、Eclipse等开发工具，创建工程项目都能作为准备上传到Github的工程项目。

        说明：在电脑桌面“Dekstop”创建一个名称为“GitNavigation” 的工程项目。

---

3.初始化工程项目为Git本机版本库

        现在，项目已经准备就绪，怎么上传到Github呢？需要注意的是，此时的“GitNavigation” 工程项目，仅为一个不是使用Git版本库管理，普通的AndroidStudio工程项目，也就不具备上传到Github的资格或功能。那么，就要使得“GitNavigation” 工程项目，转换成Git版本库管理的项目，就具备了Git版本控制系统的功能特性。

        （1）在找到GitNavigation工程项目——选择点击Git Create respository here...

        （2）工程目录自动生成的“.git”目录

---

4.提交工程项目到Git本机版本库

        当前项目具备使用Git功能特性，但此时管理项目的“.git”目录，没有检测到工程项目的资源信息，【通俗理解：你(工程项目)又不是我(Git本机版本库)女朋友，去酒吧蹦迪我(Git本机版本库)凭啥要管你(工程项目)】，因此两者要建立联系(发生关系)才有资格管！需要先把“GitNavigation” 工程项目全部资源文件添加至Git本机版本库中，然后进行commit提交，如下：

        提交工程项目到Git本机版本库工程项目分为两个步骤：

        步骤一：把需要添加的文件进行：Add添加至Git本机版本库（git add 文件名）

        步骤二：commit提交处理Add添加的文件至Git本机版本库（git commit - m "备注提交信息"）

        （1）右击GitNavigation工程项目：TortoiseGit——+ Add...

        （2）打勾Select/deselect all——OK——Success (453 ms @ 2021/8/6 21:32:54)

         （3）目录变化处于待commit提交状态：红色感叹号！不是最新版本Git本机版本库——蓝色加号+  已添加且处于待commit提交状态

        （4）commit提交至Git本机版本库：右击GitNavigation工程项目——Git commit -> "master"...（mastet是Git本机版本库默认的master主分支，也可以自定义创建分支以及重命名分支的名称）

        （5）核查提交清单——Commit——Success (375 ms @ 2021/8/6 21:56:28)——close

        （6）commit提交后工程项目和文件图标变为打勾绿色图标——即Git本机版本库最新版本

---

 5.Git本机版本库Push推送Github远程仓库

        到这里，学会Git本机版本库的基本使用流程了，可是在本机电脑管理工程项目远远不满足开发需求，因此需要Git版本库上传到Github，这样一来，任何电脑连接互联网，直接从Github远程仓库中下载工程项目到当前电脑使用，进行项目开发。

        在这之前，必须注册属于自己的Github账户，Github官方地址：https://github.com/

        （1）创建一个Github远程版本库，命名为：“GitNavigation”——默认主分支：master

---

  （2）获取“GitNavigation”远程仓库的URL地址，作用于Git本机版本库与Github远程仓库建立连接，获取方式如下：

        获取URL：code——SSH——点击图标复制——出现copied

---

        （3）使用TortoiseGit客户端上传Git本机版本库的“GitNavigation”工程项目到Github，如下：

        右击工程项目：Git sync...（同步Git和Github版本库）

---

        （4） push上传之前，使用pull获取Github远程版本库信息以及​​​​​​​分支的合并(本机master和远程master)，并且两者建立连接。

        很遗憾，Pull获取发生错误：​​​​​

        错误分析：

        原因一：创建Git远程版本库时，勾选添加了一个工程项目说明文件README.md在master主分支；Git本机版本库管理的工程项目目录中并没有Github远程版本库中的说明文件README.md​​​​​​​。

        原因二：两个master分支是两个不同的版本，具有不同的提交历史。一个有说明文件README.md​​​​​​​，一个没有说明文件README.md​​​​​​​，因此使用pull建立关系进行master合并分支时，就会发生如下错误：

fatal: refusing to merge unrelated histories

致命的:拒绝合并不相关的历史 

---

（5）解决方案：强制允许不相关历史分支合并，项目工程右击空白处——Git Bash here，使用命令——git pull origin master --allow-unrelated-histories，如下：

        步骤一：使用命令——git remote -v（查看远程仓库URL地址详细信息，可以看到仓库名称）

        步骤二：设置Github远程版本库URL地址——Manage

        步骤三：再次使用命令——git remote -v（查看远程仓库URL地址详细信息，可以看到仓库名称）

        步骤四：现在有pull和push的URL地址，进行强制允许不相关历史master分支合并，使用命令——git pull origin master --allow-unrelated-histories

Merge branch 'master' of github.com:xxxxxx/GitNavigation
翻译：允许强制合并分支 'master' 到 Github远程版本库GitNavigation中
# Please enter a commit message to explain why this merge is necessary
翻译：请输入提交消息来解释为什么需要合并
# especially if it merges an updated upstream into a topic branch.
翻译：特别是如果它合并了一个更新的上游到一个主题分支
# Lines starting with '#' will be ignored, and an empty message aborts
翻译：以'#'开头的行将被忽略，空消息将终止提交

---

      （6）TortoiseGit中再次使用pull拉取master分支合并的信息并建立本机版本库连接远程版本库——success

        （7）Git本机版本库push上传/推送至Github远程版本库

         合并成功：Success (4281 ms @ 2021/8/7 1:23:01)

---

6.Github检测Push推送成功的工程项目

***使用TortoiseGit客户端把Git本机版本库上传至Github远程版本库，整个实现流程就介绍完了***

---

7.总结

仅自己学习记录，如有错误，敬请谅解~，谢谢~~~