Git与Github常用方法

1. Github基本使用方法

• 仓库（Repository）：Github上用来存放代码的空间，包含代码、文档和其他文件。
• 提交（Commit）：Git是一种版本控制系统，它通过不断提交新的修改内容来记录代码的版本，每次提交称为一次“提交”（Commit）。
• 分支（Branch）：在Git上，每一个代码仓库都有一个主分支（master branch），每个开发者都可以从主分支上创建一个自己的分支Branch），在自己的分支上进行开发，完成开发后再将分支合并到主分支上。
• 合并（Merge）：将分支上的代码或修改合并到主分支或其他分支上。
• 请求合并（Pull Request）：开发者在自己的分支上开发完代码后，将修改请求合并到主分支或其他分支上，请求合并的过程称为“Pull Request”，开源社区的成员可以对请求进行审查和讨论。

主要操作：

1. 创建仓库：“New Repository”->“Create Repository”;
   

2. 克隆仓库：直接点击“download ZIP”（下载的只是整个项目文件）；或者用git命令" git clone https://github.com/*************.git"(下载的不仅是整个项目文件，还有仓库属性)
   

3. 上传文件：点击addfile即可或者采用git命令（详情见文章后面）
   

4. 提交更改（pull request）看到别人仓库的东西，想提出修改意见，可点击“pull request”，上传自己修改过的代码和描述。
   

5. 提交疑问（Issues）：基于查看过代码仓库的前提提交问题和提交说明，仓库创建者有权利关闭问题并和网友评论问题以及添加标签。

6. README.md文件：这个项目的整体介绍和使用的方法。

7. License文件：如果你想把这个代码抄到项目中，一定要注意license。如果是MIT这种，就代表你只要保留了原作者的一些版权信息在源代码里，基本上就可以无限制使用，也不用付费。如果有一些奇奇怪怪的LICENSE，既不是MIT也不是Apache软件基金会的那种。就需要和公司法务确认好，以避免不必要的官司和纠纷。

找开源项目的一些途径：

• https://github.com/trending/
• https://github.com/521xueweihan/HelloGitHub
• https://github.com/ruanyf/weekly
• https://www.zhihu.com/column/mm-fe

查找资源的前后缀技巧：

• 找百科大全 awesome xxx
• 找例子 xxx sample
• 找空项目架子 xxx starter / xxx boilerplate 
• 找教程  xxx tutorial

2. Git使用方法

Git是一款分布式源代码管理工具(版本控制工具) ，可以用来合作开发项目，不同阶段提交代码的回溯等等，经常与Github搭配使用。

常用Git命令：

• 克隆仓库：git clone 地址 ，例如：

   git clone https://github.com/ABC/test.git

• 初始化仓库：在本地新建一个文件夹，用git bash打开，输入git init，就可以把该文件夹当作一个git仓库使用。

  git init

• 修改名字和邮箱：第一次使用git的时候，需要设置用户的名字和邮箱。

git config --global user.name "your username" 
git config --global user.email "your email"

• 将修改或新建文件添加到暂存区：

git add 文件名    //单独添加某个文件到暂存区
git add .           //添加所有修改或新建文件到暂存区

• commit将暂存区的文件提交到本地仓库中：

git commit -m "提交描述信息"

• 查看提交的历史纪录：

git log --stat

• 在工作区（还没有commit）回滚一个文件到初始状态：

git checkout filename

• 如果已经commit，想撤回：

git reset HEAD^n     //n表示第上n个commit回滚
git reset HEAD^1    //表示撤销最后一次提交

• 以当前分支为基础新建分支：

git checkout -b branchname

• 列举所有分支：

git branch

• 切换到某个分支：

git checkout branchname

• 删除某个分支：

git branch -D branchname

• 合并分支：可能会遇到分支合并冲突（例如不同的分支均修改了之前相同文件中的同一地方代码，合并冲突时需要人为解决）

git merge branchname

• 将本地仓库与远程仓库连接起来：

git remote add origin 远程仓库地址

• 推送当前分支最新的提交到远程代码库：

git push

• 拉取远程分支最新的提交到本地：

git pull

• 将拉取远程仓库内容与本地仓库内容融合：
  git pull --rebase origin master

3. git、VS code、Github联合使用方法

1. git 和VScode安装完成后，在vscode中安装插件“Gitlens”
   
2. 用vscode打开项目文件夹。 在vscode终端中添加一个git bash终端，用于输入git命令建立和管理仓库
3. 依次进行如下操作：

git init //初始化git add .  //将当前目录下修改的所有代码从工作区添加到暂存区git commit -m  “注释”  //将缓存区内容添加到本地仓库git remote add origin 远程仓库地址  //将本地仓库与远程仓库连接起来git push origin master //将项目推送到远程仓库的master分支上

在推送过程中可能会让你登录Github账号，授予推送权限。有一种用SSH密钥的方法，可以避免每次需要进行GitHub登录验证，如下。

4. Git配置Github远程仓库SSH密钥

1. 设置本地git账户邮箱和用户名：

git config --global user.name "your username" 
git config --global user.email "your email"

2. 生成新的SSH密钥：

ssh-keygen -t rsa -C "your email"  //第一次配置连续敲回车即可，如果重新配置 选y再回车即可

3. 查看生成的密钥：

cat ~/.ssh/id_rsa.pub

4. 将密钥复制到Github账户的SSH key中，点击add ssh key：

成功状态如下：

5. 之后再用git remote add origin 远程仓库地址 ，将本地仓库与远程仓库连接，就可以直接git push或pull。

5 常见问题

1. git push或者git pull时，出现连接不上的提示（fatal: unable to access ‘XXX‘: Recv failure: Connection was reset），首先看看浏览器网页是否可以直接访问github；如果直接可以访问github网页，但依然报错，就需要刷新一下设置：

git config --global --unset http.proxy
git config --global --unset https.proxy

并且在电脑cmd命令行中输入ipconfig/flushdns，刷新一下DNS

2. git push后显示如下提示，表示远程仓库和本地仓库中，有的文件远程仓库有，本地却没有。需要先git pull --rebase origin master 拉取一下远程仓库中本地没有的文件到本地仓库，在进行git push推送。