git与gitee快速入门

前言

本文首先介绍了gitee账号注册和Git工具的安装；然后介绍了SSH公钥的生成和添加；接着介绍了如何创建gitee的远程仓库和本地仓库；最后简单介绍了git的基本操作。

git是目前最优秀的、分布式的、开源的版本控制系统，或者说一个版本控制与管理的工具。gitee、github、gitlab等都是基于git的代码托管平台，为用户提供git代码仓库和其他的一些附加服务。

OpenHarmony在gitee（https://gitee.com/openharmony）和github（https://github.com/openharmony）上都有代码仓库，但由于gitee是国内的代码托管平台，比github速度更快、更稳定一些。所以在我们进行鸿蒙开发之前，应该初步掌握git和gitee的使用。

一、注册Gitee 账号

gitee官网：https://gitee.com/

首先我们需要到gitee官网上去注册一个账号，注册流程没有什么特别的，这里就不赘述了。

gitee帮助：https://gitee.com/help

二、安装Git

2.1 Git官网

Git官网首页：https://git-scm.com/

Git下载首页：https://git-scm.com/downloads

Git支持macOS、Windows和Liunx/Unix。

2.2 Windows平台下安装

下载页面：https://gitforwindows.org/

下载页面：https://git-scm.com/download/win

选择下载合适自己系统的安装程序（如：64-bit Git for Windows Setup），然后正常安装即可，没什么需要特别说明的。

在Windows平台安装好Git之后，在文件夹中单击鼠标右键，选择“Git Bash Here”，就可以打开Git Bush终端，在终端中可以输入并执行git命令。@之前是计算机的用户名，@之后是计算机名；MINGW64表示正在运行的Git Bash的信息，后面是当前所在的目录；~表示根目录，默认情况下一般是：/c/Users/计算机用户名。

2.3 Ubuntu平台下安装

下载页面：https://git-scm.com/download/linux

1、安装git

多数情况下，我们在Ubuntu中打开一个终端窗口，然后在终端中执行以下命令安装Git就可以了。

sudo apt-get install git

安装完成之后，可执行命令：git --version，查看git的版本号。

由于Ubuntu官方仓库中的Git版本更新会有些滞后，如果希望使用最新的稳定版本，可以执行以下命令安装Git：

sudo add-apt-repository ppa:git-core/ppa
sudo apt update
sudo apt install git

2、安装git-all

也可以用以下命令安装git-all，但一般不需要。git与git-all的区别在于：git是Git的核心功能包（一般情况下够用了）；git-all除了包括Git的核心功能包之外，还包括了很多在核心功能包基础上开发的附加功能包。参考：https://ubuntuqa.com/article/11066.html

sudo apt-get install git-all

3、安装git-lfs

如果有大文件需要管理，就必须安装git-lfs。git-lfs 是 Git 的一个扩展，用来帮助git实现对大文件的版本管理，lfs是Large File Storage的缩写。顺便说一下，在git的Windows版本的安装程序中已经包含了git-lfs，不需要单独安装。

注意：git-lfs 要求 git的版本 >= 1.8.2

https://gitee.com/vcs-all-in-one/git-lfs

https://gitee.com/mirrors/git-lfs

https://gitee.com/help/articles/4235

依次执行以下指令，可以安装git-lfs。

sudo apt install curl 
curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | sudo bash
sudo apt-get install git-lfs
git lfs install

说明：在执行以下上述指令之前，已经先执行了：sudo apt-get install git-lfs从Ubuntu官方仓库安装了git-lfs，所以在执行上述第3条指令时是截图中显示的是update。

2.4 初次使用Git之前的配置

参考：https://gitee.com/help/articles/4107

在初次使用Git之前，需要先配置下自己的 Git 工作环境。配置工作只需一次，以后升级Git后还会沿用现有的配置。当然，如果需要，你随时可以用相同的命令修改已有的配置。

Git 提供了一个叫做 git config 的工具，专门用来配置或读取相应的工作环境变量，而正是由这些环境变量，决定了 Git 在各个环节的具体工作方式和行为，这些变量都是存放在相应的配置文件中的。

配置分为三级，从上到下依次为：系统级（适用系统中的所有用户）、用户级（适用当前用户中的所有仓库）、仓库级（只适用于当前仓库），上级配置会被下级同名的配置项所覆盖。

配置级别	配置命令	配置文件
系统级	git config --system	/etc/gitconfig 文件
用户级	git config --global	~/.gitconfig 文件
仓库级	git config	仓库目录下的.git/config 文件

在本地终端中执行以下命令，配置基本信息。name尽量和Gitee的用户名保持一致，但email必须是注册Gitee时使用的邮箱。命令不分前后，没有顺序。

git config --global user.name "yourname"
git config --global user.email "youremail@youremail.com"

如果需要使用 HTTPS协议在本地与远程仓库之间进行数据传输，可以用以下命令配置客户端记住密码，避免每次都输入密码。

git config --global credential.helper store

要检查已有的配置信息，可以使用 git config --list 命令。

除了上面的基本配置之外，还可以配置一些其他信息，如果需要可参考上面的链接。

三、生成/添加SSH公钥

参考：https://gitee.com/help/articles/4181#article-header0

Gitee 支持许多数据传输协议，如：HTTPS协议、SSH协议等等。如果想使用SSH协议（即：使用远程仓库的SSH地址）访问远程仓库，就必须提前配置好账户/仓库的SSH公钥，否则就只能用仓库的HTTPS地址访问仓库。

下面以Windows平台为例，生成/添加SSH公钥。Ubuntu下的命令是一样的。

3.1 生成SSH公钥

1、打开Git Bash，在终端里执行以下命令：

ssh-keygen -t ed25519 -C "xxxxx@xxxxx.com"

**注意：**这里的 xxxxx@xxxxx.com 只是生成的 sshkey 的名称，并不约束或要求具体命名为某个邮箱。现在网上的大部分教程之所以都使用邮箱生成，只是因为一开始的初衷仅仅是为了便于辨识。

2、按照提示完成三次回车，即可生成 ssh key，公钥被保存在文件： /c/Users/ASUS/.ssh/id_ed25519.pub中。

3、打开这个文件，可以查看public key。

cat /c/Users/ASUS/.ssh/id_ed25519.pub

如果按照廖雪峰的方法：https://www.liaoxuefeng.com/wiki/896043488029600/1163625339727712，执行以下命令生成SSH公钥。

ssh-keygen -t rsa -C "dandelion_jsnj@qq.com"

3.2 添加SSH公钥

1、登录gitee账号，选择“设置” – “安全设置” – “SSH公钥” – “添加公钥”。

2、在本地终端中执行以下命令。第一次执行结果如下图，会提示是否continue，输入yes后程序会自动连接，如果要求登录，直接输入登录信息即可。

ssh -T git@gitee.com

3、如果出现上图中最后一行提示，需要在本地终端中再次执行上面的命令。

四、创建gitee远程仓库

1、登录 Gitee 账号。

2、通过网站右上角的「+」号，选择「新建仓库」，进入新建仓库页面。

3、在新建仓库页面按下图所示填写仓库信息。

4、单击“创建”即可创建仓库，并进入仓库首页。如果仓库是空的，首页就如下图所示，最上面是仓库的HTTPS地址和SSH地址。单击最右边的“管理”，可以打开仓库的管理页面。

五、创建gitee本地仓库

参考：

https://gitee.com/help/articles/4122

https://gitee.com/help/articles/4109

https://gitee.com/help/articles/4111

创建一个与远程仓库相关联的本地仓库有两种方法：

方法一：直接在本地终端中执行git clone命令，就可以将远程仓库克隆到本地，创建一个与远程仓库关联的本地仓库。

git clone https://gitee.com/dandelion_jsnj/intelligent-identification.git

或者使用仓库的SSH地址：

git clone git@gitee.com:dandelion_jsnj/intelligent-identification.git

在本地仓库目录中执行命令git remote -v，可以看到本地仓库与远程仓库的关联关系。origin是远程仓库在本地的默认名称。

方法二：首先，在本地新建一个文件夹；然后，用命令git init将这个文件夹初始化成一个gitee本地仓库；最后，用命令git remote add将本地仓库与一个远程仓库关联起来。

mkdir local #新建一个文件夹
cd local
git init    #将文件夹初始化成一个gitee本地仓库
git remote add origin git@gitee.com:dandelion_jsnj/intelligent-identification.git #将本地仓库与一个远程仓库关联起来。origin是远程仓库在本地的默认名称，用于指代名称后面的远程仓库地址，也可以用其它名字。

六、Git基本操作

参考：

Git知识大全：https://gitee.com/help/categories/43

廖雪峰Git教程：https://www.liaoxuefeng.com/wiki/896043488029600

菜鸟Git教程：https://www.runoob.com/git/git-tutorial.html

要比较全面地掌握git的使用，可以参考上面这三个教程。除了本文之前已经介绍的git命令，下面再介绍最常用的两种基本操作：

1、上推（push）：From本地仓库To远程仓库。在本地仓库目录下执行以下命令：

#添加/指定要提交给远程仓库的内容。.表示所有被修改的内容，也可以指定某个文件。
git add . 
#为本次提交添加备注信息
git commit -m "对本次提交的说明" 
#将指定的内容提交给名为origin的远程仓库的master分支。
git push origin master 

2、下拉（pull）：From远程仓库To本地仓库。在本地仓库目录下执行以下命令：

#用名为origin的远程仓库的master分支更新本地仓库。
git pull origin master