掌握Github的使用

Git&Github - 飞书云文档 (feishu.cn)

一.了解Git和Github

1.什么是Git？

Git就是代码版本管理工具

2.为什么要使用Git

版本控制 保留了代码过去版本
分支管理 可以开发多个分支，最后再合并到主分支
团队协作 并行开发隔离错误审查和讨论保持主分支的稳定性

3.什么是Github

GitHub是一个基于Git的世界上最大的==代码托管平台==，同时也是一个==开源社区==，有很多不错的项目值得大家去创作。

它让开发者能够更好地进行代码管理和共同创作。我们用Git保存到本地后，就可以push(推送)到GitHub上，托管我们的代码，别人也可以pull(拉取)我们的代码，通过这种方式保存代码和进行团队协作

二.安装并配置Git

在各个系统上安装git - 飞书云文档 (feishu.cn)

三.Git基本命令

首先定位到想要存放源码的目录
目录中右键打开git bash
输入以下命令：

git config --global user.email 123@qq.com # 设置你的git的电子邮箱地址，替换自己的邮箱
git config --global user.name zhangsan # 设置你的git的名称，替换为自己的名称 
# 邮箱姓名设置一次过后，以后就不用再设置了

git init                            # 把这个文件夹初始化，并建立一个暂存区
git remote add origin 要连接的仓库网址 # 实现本地和远程仓库的连接 并将远程仓库命名为origin
git branch -M main                  # 切换到main分支
echo "# Hello World" > README.md    # 将"# Hello World!" 输入到README.md文件
                                    # 如果不存在README.md文件会自动创建一个
# 这时候，相对于暂存区，我们的文件夹是发生了变化的
git add .                           # 把所有发生了变化的文件提交到暂存区
									# 也可以用 git add xx文件 指定一个文件提交到暂存区
git commit -m "first commit"        # 将暂存区的变化设置备注为first commit 即设置提交消息
git push -u origin main             # 将你的代码push到远程仓库 暂存区会被清空`

# 理解：commit就是把一个个变化打包成一个个所谓的包裹，然后我们push的时候就是把这些包裹推送到远程仓库

# 后续如果要继续把本地文件上传到仓库里的话，只需要执行后三个命令
git add .							  # 这里涉及一个Git忽略文件.gitignore的使用
git commit -m "xxx"     			  # 这里就涉及到了一个规范commit的问题
git push -u origin main

四.Pull Request(PR)

PR 的主要应用场景是在对他人的 Git 仓库本地修改后进行代码提交，在这个过程中可以与仓库所有者进行交流，并且完善代码。

大致流程:你想要修改某仓库的代码，但是这个仓库你没有操作权限，所以需要复制一份(Fork)给你自己的账号，然后作出修改(commit)，最后提交回去(PR)

具体操作:

1.fork某仓库
2.将复制的仓库clone到本地自己指定一个本地文件夹打开git bash git clone 自己github所复制仓库的url
3.修改本地文件夹

4.提交代码

1
2
3

git add .							  
git commit -m "xxx"     			 
git push -u origin main

5.发起Pull Request

在自己所复制仓库中点击’contribute’ -> ‘open pull request’

==在 Pull Request 创建后，仍可以继续 Commit, Push 来补充修改，新的 Commit 将自动附加到这个 PR 末尾==，也就是你无需为了修改当前 PR 的一些内容而开新的 PR。

参考文章：

五.规范Commit

commit message 格式：type(scope):subject

举例：fix(DAO):用户查询缺少username属性

type(必须)

用于说明git commit的类别，只允许使用下面的标识。
- feat：新功能（feature）
- fix/to：修复bug，可以是QA发现的BUG，也可以是研发自己发现的BUG。
- docs：文档（documentation）
- refactor：重构（即不是新增功能，也不是修改bug的代码变动）。
- test：增加测试。
- merge：代码合并。
- perf：优化相关，比如提升性能、体验。
scope(可选)

scope用于说明 commit 影响的范围，比如数据层、控制层、视图层等等，视项目不同而不同。
subject(必须)

subject是commit目的的简短描述，不超过50个字符