零、从Github开始

一、github 创建和管理自己的代码仓库

在Github 上面创建或Fork一个代码仓库总共就需要做两件事：创建公钥+克隆
总共需要两个git 的命令行语句

ssh-keygen  //创建ssh公钥和密钥
git clone xxx //克隆某个代码仓库

ssh-keygen

在任意一个想要保存代码的文件夹里面右单击，打开Git Bash

选择Git Bash Here

1. 输入ssh-keygen
2. 在提示你输入私钥保存的位置，直接回车使用默认位置即可
3. 后面两次提速输入密码Enter passphrase 的时候直接回车，就可以。

ssh-keygen如果输入密码，后面用visual code的时候会出现不能自动登录，以后可能都需要用git命令，那就比较麻烦。所以这个地方不要输入密码，直接回车

4. 一切顺利的话，会出现如下画面
   
5. 根据提示找到公钥文件，以本图为例：Your public key has been saved in /c/Users/Administrator/.ssh/id_rsa.pub 我们可以到c:/Users/Administrator/.ssh文件夹里面，用记事本打开id_rsa.pub，把里面的公钥复制出来，公钥类似如下，以ssh-rsa开头

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQCYc06HS4QI/cEiIYZrlkfHD+M6BD3di/TMqXHup+N0XHl9IvEcCZlE9tg6N8LiLgn8qrZSEdfDfS3xaZTcMdPx3tb2i/+oq4Swujzf8QIARJ92BPY8T...后面省略

6. 进入Github的账号设置里面（setting->Access->SSH and GPG keys）把复制出来的公钥填写进去就可以了。
   

clone

进入创建好的代码仓，找到Code->SSH，把代码仓地址复制出来

在Git Bash 里面执行clone指令，类似下面这样：

git clone git@github.com:JimmyTsai75/MyTest.git

成功之后，就可以把代码仓里面的源代码克隆下来，如下所示：

Visual Code代码管理

用vscode打开clone下来的代码文件夹，修改代码并保存（可以尝试任意修改一个代码的内容或添加一个文件，如果没有新的代码，代码管理界面里面会是空白的）


对于git分支，如果没有借助工具就会比较抽象。
推荐vscode上一个插件git graph,具备和SourceTree一样的展示功能，如下图所示：

安装完，进入vscode的源代码管理，可以看到多了一个按钮

另外，vscode还提供诸如同步，推送等git功能，具体可以通过点击源代码管理里面的折叠按钮，如下图：

二、团队合作

当我们需要多人合作，协同开发的时候，我们需要创建团队开发模式。团队开发模式有许多种，比较适合我们的是复刻和拉取模式（Fork and pull model）
在复刻和拉取模型中，任何人都可以复刻现有仓库并推送对其个人复刻的更改。 不需要对来源仓库的权限即可推送到用户拥有的复刻。 项目维护员可将更改拉入来源仓库。 将提议更改的拉取请求从用户拥有的复刻打开到来源（上游）仓库的分支时，可让对上游仓库具有推送权限的任何人更改您的拉取请求。

创建组织

Github里面，对源代码权限的管理需要通过Organizations和team来实现，因此我们需要先创建Oganizations。进入your organizations->New organization,选择Create a free organization(免费版本就够用了)
创建完成之后，进入该组织settings，选择Member privileges进行成员权限设置，默认是不允许fork的，这个要打开，如下图

创建代码仓和Team

进入组织，选择Repositories->create a new repository,创建代码仓。如果不是想要开源，选择Private，创建好代码仓之后，进入setting->Access，点击Collaborators and teams

进入team之后，就可以邀请团队成员了。

开发分支

github 因为black lives matter运动，默认分支现在改为main(原来是master)，一般用来发布稳定版本，通常的做法是再创建一个dev分支（开发分支）用来发布开发版本。
在代码仓首页找到main分支，下拉后可以看到查看所有分支的选项，如下图

进入分支管理界面，创建新的分支并dev，点击即可创建。
创建完成后，进入repositions的setting,选择Branches，把新建的dev分支设置为默认分支

Fork

登录github之后，找到要Fork的代码仓。

剩下的事情就和管理自己的代码仓库是一样的。

Pull request

团队开发和个人开发不一样的地方就是要注意代码同步，建议的做法是每天开发代码之前，Sync fork同步一下主仓，代码开发后提交到主仓。

Fork 主仓之后，实际操作的是主仓的一个分叉。在Visual Code 里面同步之后，只是同步到自己账号下的分叉仓，还需要通过Contribute里面的Open pull request进行对主仓进行拉取请求。主仓管理员Review代码之后，在合并到主仓。