小傅哥 bugstack 虫洞栈

# Git 使用说明和配置

作者：小傅哥
博客：https://bugstack.cn (opens new window)

沉淀、分享、成长，让自己和他人都能有所收获！😄

大家伙，我是技术UP主小傅哥。

不会Git操作的伙伴，轻则写不了代码，重则误操作搞丢自己的代码或者干掉别人的代码。 因为进入公司后，就不只是你一个人在一个工程上写代码，而是所有这个项目组的伙伴都需要在这个工程上写代码，大家要在统一的Git的规范完成代码开发和提交。—— 🤨 不信的话，进入公司乱删个Git分支或者随便任何一个分支提交代码试试。

Git的作用是什么？

你可以想象下，当你有10个小伙伴都需要在一个 txt 文档里，写一份老师👩🏻‍🏫上课的笔记📒，把信息进行汇总、互相完善、用于课后学习。那么怎么保证大家做的课堂内容都能顺利的写在一份 txt 呢，而且不要互相删除，也不要丢失谁的信息呢？

这个就是 Git 的用途。Git 是一种分布式版本控制系统，用于高效地管理和跟踪源代码和文件的历史记录，支持多人协作开发及分支管理，提供可靠的版本回退和合并机制，从而提高开发效率和代码质量。

# 1. Git 起源故事

讲到 Git 就不得不提一下 Linux，因为如果没有 Linux 也就没有 Git 的诞生，这里是有一段 10天 写出 Git 的故事！

众所周知，Linus 于 1991年 创建了开源的 Linux，从此 Linux 系统不断发展壮大。但 Linux 的壮大是靠全世界热心的开发者参与的，不过这么多人在世界各地为 Linux 编写代码，那代码是如何管理的呢？事实是，2002 之前，合并代码的操作都是 Linux 老爷子自己手动合并的！

但 2000 年的时候，不是已经 SVN (opens new window) 可以使用了吗？但 Linus 坚决反对 CVS、SVN 这些集中式的管理工具，不仅速度差还得联网操作。虽然有商用版的功能好一些，但这与 Linux 开源精神不符。所以 Linus 就不用，看人家这开源精神！

不过到了 2002年，Linux 都发展10年了，在这么手动的合并代码，让社区的兄弟也苦不堪言，强烈反对。为此，林纳斯·托瓦兹（Linus Torvalds）决定使用 BitKeeper 作为 Linux 内核主要的版本控制系统用以维护代码。BitKeeper 的东家 BitMover 公司，看 Linux 开源的不容易，授权 Linux 社区免费使用这个版本控制系统。

哈哈哈，但好景不长！2005年，安德鲁·垂鸠（Andrew Tridgell）写了一个简单程序，可以连接 BitKeeper 的仓库，BitKeeper 著作权拥有者拉里·麦沃伊认为安德鲁·垂鸠对 BitKeeper 内部使用的协议进行逆向工程，决定收回无偿使用 BitKeeper 的许可。Linux 内核开发团队与 BitMover 公司进行磋商，但无法解决他们之间的歧见。林纳斯·托瓦兹决定自行开发版本控制系统替代 BitKeeper ，以10天的时间编写出 git 第一个版本！—— 牛皮！

有了 Git 以后，GitHub 平台也于2007年10月1日开始开发。网站于2008年2月以beta版本开始上线，4月份正式上线。GitHub 里面的项目可以通过标准的 Git 命令进行访问和操作。—— 这就是 Linux、Git、Github 的故事。

# 2. 软件安装

Git 是一个软件工具，在使用前需要进行安装。

# 2.1 Mac

# 如果你没有 brew 命令，则需要先安装下；https://brew.sh/index_zh-cn
brew install git
1
2

# 2.2 Windows

# 2.3 Linux

# Debian/Ubuntu

获取适用于您的 Debian/Ubuntu 版本的最新稳定版本

# apt-get install git
1

对于 Ubuntu，此 PPA 提供最新的稳定上游 Git 版本

# add-apt-repository ppa:git-core/ppa
# apt update; apt install git
1
2

# Centos

sudo yum install git
1

# 3. 配置账户

当你拿到一个Git的仓库（Github、Gitcode、Gitee、GitLab），让你克隆（git clone）代码的时候，不要虾呵呵的上去就点个zip下载。

  • zip 下载的代码，只是当前分支的，下载后用 IntelliJ IDEA 打开也没有 Git 标识，不能进行仓库的pull、push、checkout等操作。
  • 另外对于一些工程内容比较大的项目，直接 zip 下载还可能会失败。

你要做都是配置账户 ssh 秘钥，或者下载的时候输入 git 仓库账号密码（目前很多仓库为了安全，不在支持账号密码方式下载代码了。）

# 1. 配置git账户

[root@lavm-aqhgp9nber ~]# git config --global user.name "fuzhengwei"
[root@lavm-aqhgp9nber ~]# git config --global user.email "184172133@qq.com"
1
2
  • 用户名和邮箱，更换为你的代码库注册使用的名称和邮箱📮。

# 2. 创建ssh秘钥

[root@lavm-aqhgp9nber ~]# ssh-keygen -t rsa -C "184172133@qq.com"
Generating public/private rsa key pair.
Enter file in which to save the key (/root/.ssh/id_rsa): 
Enter passphrase (empty for no passphrase): 
Enter same passphrase again: 
Your identification has been saved in /root/.ssh/id_rsa.
Your public key has been saved in /root/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:lgf+3a1srOvDD0znv+/jiR3iwMaZtxW94k9FI1HzJAk 184172133@qq.com
The key's randomart image is:
+---[RSA 2048]----+
|            Eoo+.|
|              ooo|
|        .    . .o|
|       . o    ..o|
|        S . . ..o|
|       . oo+o+ .+|
|          .O+=o=.|
|          . Bo@+o|
|           .+@*BB|
+----[SHA256]-----+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
  • 命令：ssh-keygen -t rsa -C "184172133@qq.com"
  • 操作：一路敲回车同意就可以了。

# 3. 获取ssh秘钥

[root@lavm-aqhgp9nber ~]# cat /root/.ssh/id_rsa.pub 
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC7eYQiDe46Jq5CJ6vXtIiM0hxUKKgCoSFIkSQucsZoLjhW53guxmZ0aR+gUZb/M8Xgrk9WMxc32KqQasFy0xPo86Hxagd40fPz+XdwOyokEJC5He6F1********CkATF2YgEdtcRW2RPICjtLr*******DWkS8ez 184172133@qq.com
1
2
  • 命令：ssh-keygen -t rsa -C "184172133@qq.com"
  • 操作：Your public key has been saved in /root/.ssh/id_rsa.pub. 按照提示地址，获取 pub 公钥。如果是linux就通过 cat 获取。如果是本机电脑就按照路径打开。
  • 注意：.ssh 点开头的文件夹是隐藏文件，Windows/Mac 都可以设置查看隐藏文件。Windows 是设置里配置，Mac 是通过 Shift + Command + . 开启和关闭查看隐藏文件。

# 4. 配置ssh秘钥

# 4.1 gitcode.net

# 4.2 github.com

其他的各个代码库平台也都类似，找到配置 ssh 秘钥的地方，把 id_rsa.pub 内容填充进去即可。

# 4. 检出代码 - 命令

通过在公司工作，大家会说检出代码，不会说下载。因为检出对应的是 git clone 命令，而下载是 http 直接点击链接。在我们使用一些图形化的 git 界面操作代码检出的时候，走的也是 git clone 命令。

# 4.1 检出地址

  • 地址：选择工程的 ssh 地址，这个是你配置 ssh 秘钥后的检出方式。

# 4.2 检出命令

# 4.2.1 默认检出（master）

git clone git@github.com:fuzhengwei/openai-code-review.git
1
  • 你可以复制你需要的工程地址进行检出。

# 4.2.2 指定分支

git clone -b 240720-xfg-init-project git@github.com:fuzhengwei/openai-code-review.git
1
  • 添加 -b 分支名，可以指定分支名称检出。

# 4.2.3 其他命令

  • git branch：查看当前工程分支
  • git branch -r：查看远程分支列表
  • git pull：拉取分支最新代码
  • git push：推送本地变更的代码。【这样的操作有图形化界面，更方便】
  • git fetch：后去远程仓库最新分支变动，这个很有用。在你想操作分支创建新或者看其他人的分支时候，先操作下 git fetch 看下最新的分支变动。
  • git merge origin/master：将远程分支的 master 代码合并到本地分支 master 上。【类似这样的操作有图形化界面，点击即可】

# 5. 检出代码 - IntelliJ IDEA

IntelliJ IDEA 本身就提供了 Git 的图形化操作，也是最简单最常用的方式。只要你的代码是通过 Git 检出的，那么通过配置 Git 的 IntelliJ IDEA 打开工程，就会自动的被 Git 管理。

# 5.1 配置 Git

  • 像是 Mac 电脑会自动默认的配置好 IntelliJ IDEA Git 直接使用即可，如果你的电脑在 IntelliJ IDEA 打开工程后，提示没有 Git 则可进入设置手动配置。
  • 配置后，点击 Test 可以测试出 Git 的版本。

# 5.2 检出代码

# 5.2.1 方式1；打开工程前

# 5.2.2 方式2；打开工程后

  • 打开工程后，也可以通过菜单栏中的 Git 进行检出操作。

# 5.3 图形界面

# 5.3.1 分支使用

# 5.3.2 提交代码

# 5.3.3 查看记录

# 5.3.4 查看对比

  • 这个代码对比非常适合代码评审，也可以用于自己学习代码。可以知道任意两个分支的代码差异，也就知道了代码上一次是什么样，这一次是做了什么开发。

# 5.3.5 合并分支

  • 在实际的开发中，大家承接新的需求，会从master拉一个新的分支。拉取后，开始编写代码，完成开发后提交。
  • 之后切换到master分支，通过把自己的开发的分支合并回master分支进行提交。
  • 注意：如果多人开发，同时修改一个类，可能会引起合并冲突，这个审核要点开类，查看冲突进行合并，不要把自己和他人的代码合并丢失。

# 5.3.6 回滚分支

# 6. 提交工程 - IntelliJ IDEA

那么首次创建的工程怎么提交到代码库呢？🤔

# 6.1 创建本地仓库

  • Create Git repository 创建一个本地的暂存库。你可以把开发的内容暂时提交到本地仓库中。

# 6.3 提交本地代码

  • 把本地仓库提交到本地代码库待提交列表中。
  • 后续你在创建的代码，会默认自动加入进来。如果你是通过打开文件夹复制进去的，不会被添加，需要手动 +Add
  • 添加后就可以参考 5.3 中的操作提交代码了。

# 6.4 创建远程仓库

你可以选择 GitHub/GitCode/Gitee/GitLab 任意地方创建自己的工程库。教程；

# 6.5 推送本地工程

  • 最后推送完成就可以看到自己的代码进入仓库中了！

# 7. 操作界面 - git-gui

Git 附带了用于提交 ( git-gui (opens new window) ) 和浏览 ( gitk (opens new window) ) 的内置 GUI 工具，但也有一些第三方工具可供用户寻求特定于平台的体验。

# 8. 提交规范

分支命名：日期_姓名首字母缩写_功能单词，如：210804_xfg_buildFramework

提交规范：作者，type: desc 如：小傅哥，fix：修复查询用户信息逻辑问题 参考Commit message 规范

# 主要type
feat:     增加新功能
fix:      修复bug

# 特殊type
docs:     只改动了文档相关的内容
style:    不影响代码含义的改动，例如去掉空格、改变缩进、增删分号
build:    构造工具的或者外部依赖的改动，例如webpack，npm
refactor: 代码重构时使用
revert:   执行git revert打印的message

# 暂不使用type
test:     添加测试或者修改现有测试
perf:     提高性能的改动
ci:       与CI（持续集成服务）有关的改动
chore:    不修改src或者test的其余修改，例如构建过程或辅助工具的变动
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

# 9. 操作手册

  • 中文PDF，直接深度学习Git操作！下载：微信公众号「bugstack虫洞栈」回复「gitbook」

← Github →