【Git】远程操作

理解分布式版本控制系统

我们目之前所说的所有内容（工作区，暂存区，版本库等等），都是在本地！也就是在你的笔记本或者计算机上。而我们的Git其实是分布式版本控制系统！什么意思呢？

可以简单理解为，我们每个人的电脑上都是一个完整的版本库，这样你工作的时候，就不需要联网了，因为版本库就在你自己的电脑上。既然每个人电脑上都有一个完整的版本库，那多个人如何协作呢？比方说你在自己电脑上改了文件A，你的同事也在他的电脑上改了文件A，这时，你们俩之间只需要把各自的修改推送给对方，就可以互相看到对方的修改了。

分布式版本控制系统的安全性要高很多，因为每个人电脑里都有完整的版本库，某一个人的电脑坏掉了不要紧，随便从其他人那里复制一个就可以了。

在实际使用分布式版本控制系统的时候，其实很少在两人之间的电脑上推送版本库的修改，因为可能你们俩不在一个局域网内，两台电脑互相访问不了。也可能今天你的同事病了，他的电脑压根没有开机。因此，分布式版本控制系统通常也有一台充当“中央服务器”的电脑，但这个服务器的作用仅仅是用来方便“交换”大家的修改，没有它大家也一样干活，只是交换修改不方便而已。有了这个“中央服务器”的电脑，这样就不怕本地出现什么故障了（比如运气差，硬盘坏了，上面的所有东西全部丢失，包括git的所有内容）。

远程仓库

Git是分布式版本控制系统，同一个Git仓库，可以分布到不同的机器上。怎么分布呢？最早，肯定只有一台机器有一个原始版本库，此后，别的机器可以 “克隆” 这个原始版本库，而且每台机器的版本库其实都是一样的，并没有主次之分。

你肯定会想，至少需要两台机器才能玩远程库不是？但是我只有一台电脑，怎么玩？

其实一台电脑上也是可以克隆多个版本库的，只要不在同一个目录下。不过，现实生活中是不会有人这么傻的在一台电脑上搞几个远程库玩，因为一台电脑上搞几个远程库完全没有意义，而且硬盘挂了会导致所有库都挂掉。

实际情况往往是这样，找一台电脑充当服务器的角色，每天24小时开机，其他每个人都从这个“服务器”仓库克隆一份到自己的电脑上，并且各自把各自的提交推送到服务器仓库里，也从服务器仓库中拉取别人的提交。

完全可以自己搭建一台运行Git的服务器，不过现阶段，为了学Git先搭个服务器绝对是小题大做。好在这个世界上有个叫 GitHub 的神奇的网站，从名字就可以看出，这个网站就是提供Git仓库托管服务的，所以，只要注册一个 GitHub 账号，就可以免费获得 Git 远程仓库。

github是国外的网站，速度比较慢，我们采用gitee来托管代码。下来，我们从零开始，使用一下gitee远程仓库。

创建远程仓库

在 gitee 上注册并登录账号，在头像旁边点击新建仓库：

创建成功后，我们可以对远程仓库进行一个基本的设置：开源or私有

从创建好的远程仓库中我们便能看到，之前在本地学习过的分支，也存在于远程仓库中并被管理起来了。刚创建的仓库有且只有一个默认的 master 分支

在 Gitee 远程仓库中，这两个功能的用处如下：
Issues：主要用于跟踪问题、功能请求、建议等。开发者或项目相关人员可以创建新的 Issue 来报告软件缺陷、提出新功能需求、询问疑问等。团队成员可以在对应的 Issue 下进行讨论、交流想法、更新进展等，方便对项目中各种事项进行管理和跟进，促进信息共享和沟通协作。

Pull Requests：简称 PR，当开发者在自己的分支上完成了开发、修改等工作后，想要将这些更改合并到目标分支（比如主分支）时，就可以创建一个 Pull Request。它允许其他团队成员对提交的更改进行审查，查看代码是否符合规范、功能是否正确、是否存在潜在问题等。在审查过程中，审查者可以提出评论和建议，提交者可以根据反馈进行修改，最后在达成共识后，将代码合并到目标分支，实现代码的集成和更新。

由于这里只有一个主分支，我们后面再讲。

 
在 Gitee 远程仓库等项目中，README 文件是一种重要的文档，主要有以下用途：
项目概述：向潜在用户、贡献者等介绍项目的目标、功能、适用场景，以及它所解决的具体问题，突出项目独特之处和为用户带来的好处，让他人快速理解项目核心价值，高质量的概述还能吸引更多人试用项目、在开源社区建立信誉。
安装指南：详细说明项目的安装和配置方法，包括软件先决条件、依赖关系、必要的环境设置等，以确保用户能无障碍地开始使用项目，通常步骤结构清晰，还可能配以代码示例和截图辅助用户完成安装。
使用说明：帮助用户理解如何使用软件或项目，涵盖主要功能描述、操作步骤、配置选项等，常包含示例代码、屏幕截图、常见问题解答等，增加项目可用性，助力用户充分挖掘项目潜力。
贡献指南（对开源项目）：指导希望对项目做出贡献的开发者如何参与，比如说明贡献流程、代码规范等。
其他信息：还可能包含项目的版本信息、许可证信息、作者信息、联系方式等内容，方便使用者和项目相关人员了解更多背景和联系沟通。

可以看到ReadMe文件有两个版本一个是中文版的，一个是英文版的。

克隆远程仓库

克隆/下载远端仓库到本地，需要使用 git clone 命令，后面跟上我们的远端仓库的链接，远端仓库的链接可以从仓库中找到：选择“克隆/下载”获取远程仓库链接：

SSH 协议和 HTTPS 协议是 Git 最常使用的两种数据传输协议。SSH 协议使用了公钥加密和公钥登陆机制，体现了其实用性和安全性，使用此协议需要将我们的公钥放服务器，由 Git 服务器进行管理。使用 HTTPS 方式时，没有要求，可以直接克隆下来。

需要注意的是：不建议在我们本地的仓库中使用 git clone 因为这样可能造成文件冲突的风险、项目建构紊乱、版本管理混乱

使用 HTTPS 方式

此时就多出了一个文件夹

可以看到这个文件夹里面有一个 .git 文件夹，这个我们之前讲过的，就是版本库，而其他的文件我们都是可以在 gitee 上看到的

使用 SSH 方式

使用 SSH 方式克隆仓库，由于我们没有添加公钥到远端库中，服务器拒绝了我们的 clone 链接。需要我们设置一下：

第一步：创建 SSH Key。在用户家目录下的 .ssh 目录，看看这个目录下有没有 id_rsa 和 id_rsa.pub 这两个文件，如果已经有了，可直接跳到下一步。如果没有，需要创建 SSH Key：

我这台机器没有，所以需要创建一下，命令：
ssh-keygen -t rsa -C "email@example.com"，这里建议将邮箱写成和 gitee 一致

顺利的话，可以在用户主目录里找到 .ssh 目录，里面有 id_rsa 和id_rsa.pub 两个文件，这两个就是SSH Key的秘钥对， id_rsa 是私钥，不能泄露出去， id_rsa.pub 是公钥，可以放心地告诉任何人

如果想修改注释中的email内容，较为直接的方法是重新生成 SSH 密钥。使用 ssh-keygen -t rsa -C "新的email" 命令重新生成密钥对，这样会生成一个带有新注释的新密钥对。需要注意的是，重新生成密钥后，要将新的公钥添加到远程服务器或相关的认证系统中，替换原来的公钥，以便能继续使用 SSH 进行认证访问。

第二步：添加自己的公钥到远端仓库。

点击确认后，需要对你进行认证，输入你的账号密码即可。至此，我们的准备工作全部做完，欢快的 clone 吧。


如果有多人协作开发，GitHub/Gitee允许添加多个公钥，只要把每个人的电脑上的Key都添加到GitHub/Gitee，就可以在每台电脑上往GitHub/Gitee上提交推送了。

当我们从远程仓库克隆后，实际上Git会自动把本地的master分支和远程的master分支对应起来，并且，远程仓库的默认名称是origin。在本地我们可以使用git remote命令，来查看远程库的信息，如：

或者，用 git remote -v 显示更详细的信息：

上面显示了可以抓取和推送的 origin 的地址。如果没有推送权限，就看不到 push 的地址。推送是什么意思呢，继续往下看

向远程仓库推送

我们将本地的内容推送到远端，过程大概是这样的：

此时我们要将本地的 master 分支推送到 origin 主机的 master 分支，则可以：

需要注意的是，我们克隆下来一个git仓库以后，也是需要添加用户名和邮箱配置的，不然就会这样。

配置用户名和邮箱在前面说过了，所以这里就不演示了。

可以看到，我们在提交以后，之前我们在本地操作的时候，它就只会提示工作区是干净的，但现在因为是远程仓库，所以还会提示我们 push 到远端。如何将本地仓库的内容推送至远程仓库呢，需要使用 git push 命令，该命令用于将本地的分支版本上传到远程并合并，命令格式如下：

# ⽤于将本地的分⽀版本上传到远程并合并，完整命令格式如下：
git push <远程主机名> <本地分⽀名>:<远程分⽀名>
# 如果本地分⽀名与远程分⽀名相同，则可以省略冒号：
git push <远程主机名> <本地分⽀名>

推送成功！这里由于我们使用的是 SSH 协议，是不用每一次推送都输入密码的，方便了我们的推送操作。如果你使用的是 HTTPS 协议，有个麻烦地方就是每次推送都必须输入口令。

接下来，看看码云远端：

代码已经被推送至远端了：

拉取远程仓库

在 gitee 上点击 file.txt 文件并在线修改它:

此时，远程仓库是要领先于本地仓库一个版本，为了使本地仓库保持最新的版本，我们需要拉取下远端代码，并合并到本地。Git 提供了 git pull 命令，该命令用于从远程获取代码并合并本地的版本。格式如下：

# ⽤于将远程的分⽀版本拉取到本地并合并，完整命令格式如下
git pull <远程主机名> <远程分⽀名>:<本地分⽀名>
# 如果远程分⽀是与当前分⽀合并，则冒号后⾯的部分可以省略。
git pull <远程主机名> <远程分⽀名>

忽略特殊文件

在日常开发中，我们有些文件不想或者不应该提交到远端，比如保存了数据库密码的配置文件，那么怎么让Git知道呢？在Git工作区的根目录下创建一个特殊的.gitignore文件，然后把要忽略的文件名填进去，Git就会自动忽略这些文件了。

不需要从头写 .gitignore 文件，Gitee在创建仓库时就可以为我们生成，不过需要我们主动勾选一下。

如果当时没有选择这个选项，在工作区创建一个也是可以的。无论哪种方式，最终都可以得到一个完整的 .gitignore 文件，例如我们想忽略以.so和.ini结尾所有文件，.gitignore 的内容如下：

# 这是一个注释, 以下是忽略所有以 .so, .ini 为后缀的文件
*.ini
*.so

# 如果有一个以.so为结尾的文件，我们不想让它被忽略，可以这样做
!b.so

把指定文件排除在 .gitignore 规则外的写法就是 ! +文件名，所以，只需把例外文件添加进去即可。

从这里可以看出，.gitignore 文件在工作区时，就已经生效了，因为我们分别创建了 a.so 和 b.so 但只有 b.so 被提交到了暂存区，因为我们在.gitignore 里面写的是，忽略所有以.so结尾的文件，但是没有忽略 b.so

如果我们想提交被忽略的某个文件，除了上面那种方式，还可以使用 git add -f [filename] 来提交到暂存区

接下来我们将以上文件先提交到版本库中：

检验 .gitignore 的标准就是 git status 命令是不是说 working tree clean 。我们发现Git 并没有提示在工作区中有文件新增，果然 .gitignore 生效了！此时我们将暂存区的内容推送到远端：

但有时候，我们想提交一个文件，但就是被忽略，此时 .gitignore 中的内容太多了，我们不知道是那句语法写得有问题，比如说 a.so 文件是要被添加的，可以用 git check-ignore -v 命令检查：

Git 会告诉我们， .gitignore 的第3行规则忽略了该文件，于是我们就可以知道应该修订哪个规则。

给命令配置别名

在我们使用 Git 期间，有些命令敲的时候着实让人头疼（太长了），幸运的是，git支持对命令进行简化！

举个例例，将 git status 简化为 git st ，对应的命令为：

git config --global alias.st status

--global 参数是全局参数，也就是这些命令在这台电脑的所有Git仓库下都有用。如果不加，那只针对当前的仓库起作用。
现在敲 git st 看看效果：

我们再来给一个命令起别名：

git log --pretty=oneline --abbrev-commit

标签管理

理解标签

标签 tag，可以简单的理解为是对某次 commit 的一个标识，相当于起了一个别名。例如，在项目发布某个版本的时候，针对最后一次 commit 起一个v1.0这样的标签来标识里程碑的意义。

这有什么用呢？相较于难以记住的 commit id，tag 很好的解决这个问题，因为tag一定要给一个让人容易记住，且有意义的名字。当我们需要回退到某个重要版本时，直接使用标签就能很快定位到。

创建标签

在Git中打标签非常简单，首先，切换到需要打标签的分支上，然后，敲命令 git tag [name] 就可以打一个新标签，并且可以用命令 git tag 查看所有标签：

默认标签是打在最新提交的 commit 上的。那如何在指定的 commit上打标签呢？方法是找到历史提交的 commit id，然后打上就可以了，示例如下：

此时，我们查看 .git 文件夹，也可以看到我们所打的标签：

Git 还提供可以创建带有说明的标签，用 -a 指定标签名，-m 指定说明文字，格式为：

git tag -a [tagname] -m "XXX" [commit_id]

如果我们想为已经打过了的标签做说明可以这样：

git tag -a -f [tagname] -m "XXX" [commit id]

-a选项用于创建一个带注释的标签，-f选项用于强制更新已存在的标签。命令格式为:

 git tag -a -f <tagname> -m <message> [commit id]

我们可以用 git show [tagname] 查看标签信息。

标签打错了也可以删除：git tag -d [tagname]

推送标签

因为创建的标签都只存储在本地，不会自动推送到远程。所以，打错的标签可以在本地安全删除。

如果要推送某个标签到远程，使用命令 :
git push origin <tagname>

此时就能看到这里更新了

当然，如果你本地有很多标签，也可以一次性的全部推送到远端：

git push origin --tags

如果标签已经推送到远程，要删除远程标签就麻烦一点，先从本地删除：

git push origin :refs/tags/v1.0

:在git push命令中用于分隔本地引用和远程引用。在这里，冒号前面为空，表示没有指定本地的标签或分支等引用。冒号后面指定了远程仓库中的引用，这种格式通常用于删除远程引用。