GitHub简明教程1

1. 要明白git和GitHub的关系：

       git是一个版本管理工具，GitHub是git的一个网上托管平台。也就是说，git实现本地管理，但是只能在自己的电脑上工作，如何在另一个机器上同样实现该软件的开发，还有不同地方的人，如何协作开发一款软件，则需要上传到线上，大家都可以通过互联网下载来使用，继续开发，协同工作，github就是实现这个功能的。

2. 安装git

       Windows系统安装：在https://gitforwindows.org/下载后，一路默认安装好之后，启动git bash，进行git的设置。

首先设置user和email，下面的“firstname lastname”和“your_email@examlple.com”换成你自己的名字和邮箱

         

$git config --global user.name "firstname  lastname"
$git config --global user.email "your_email@example.com"

3. 设置SSH Key 

       git和github相互通信、传数据，是需要先相互认证的，认证的方式是SSH秘钥。先要通过git来生成秘钥，然后将秘钥添加到github中。

以下通过Git Bash来创建SSH Key：

$ssh-keygen -t rsa -C "your_email@example.com"
Generating public/private rsa key pair
enter file in which to save the key
(/user/your_user_directory/.ssh/id_rsa):按回车键
enter passaphrase(empty for no passphrase):输入密码
enter same passphrase again：在次输入密码

其中，id_rsa文件是私有秘钥，id_rsa.pub是公开秘钥，这两个文件是在C:/users/xxx/.ssh/下（xxx是你的电脑系统账户）

这里的密码要记住，因为在以后的git和github数据传输（clone）需要这个密码进行认证。

4. 添加SSH Key

       在github中添加SSH Key公开秘钥，私有秘钥和公开秘钥是一对，通过私有秘钥就可以和公开秘钥认证。

在github中的account settings添加SSH Key，有title和key两个框需要填写，title中写上自己感觉良好的名称，key部分粘贴id_rsa.pub中的内容，可以通过以下方法查看id_rsa.pub中内容

$cat ~/.ssh/id_rsa.pub

添加好后，可以用私有秘钥和github进行认证和通信了，测试一下:

$ssh -T git@github.com   
...
are you sure you want to continue connecting(yes/no)?输入yes

出现如下就说明认证成功：

you have successfully authenticated,but github does not provide shell acess

5. 创建仓库

       仓库是git用来存储软件历史版本的文件夹，创建公开的仓库（repository）就可，私有仓库收费，当前没必要用。如何创建比较简单，不赘述。

6. 将代码git到github上

       步骤是：先将github上的仓库clone到本地（形成本地仓库）—>将代码提交到本地仓库，在push到github上

• 将github上的仓库clone到本地，比如你在github上创建了MyRepo仓库，用以下命令：

$git clone git@github.com:accountname/MyRepo.git

其中accountname换成你的github账号名称，另外上面命令运行后，会让你输入公开你要的密码，这个密码就是生产SSH Key时设置的密码。

认证成功后，仓库便会clone到本地中，本地会有和github上同名的仓库MyRepo（在C:/Users/xxx/路径下(xxx是你的电脑系统账户)），以后将要上传的代码提交至这个仓库，在push到github的仓库中就可以了。下面进行提交

• 代码提交到本地仓库，然后push到github

比如新建了一个python脚本：helloWorld.py，通过以下命令提交至本地仓库

$git add helloWorld.py
$git commit -m "add helloWorld.py" 

通过git add 将文件加入暂存区，再通过git commit命令提交

注意：必须将git bash命令符的路径cd(切换)到本地仓库MyRepo下，并且helloWorld.py文件也要拷贝到MyRepo仓库中，否则会出现error：

fatal: not a git repository (or any of the parent directories): .git

通过git log命令可以查看提交日志

$git log

进行push，参照以下命令：

$git push 

注意：push运行后，需要输入SSH Key密码认证，只要git和github相互传数据，就要认证，认证的操作就是输入密码，这样就将本地代码提交到github上了。另外提交代码文件夹和提交具体代码的相同的操作。

参考文献：《github入门与实践》

可在https://pan.baidu.com/s/1NGLU_6HHH72EjFewyWUW1g中下载《github入门与实践》