AS中Git与GitHub的使用入门

一直想把自己的写的开源小项目放到github中，这两天才花时间来学学Git。遇到些问题，百度了很多才解决。跟SVN一样，值得写一篇总结记录下，虽然上资源很多，但作为入门，自己遇到的写出来完全不一样。

一、 Git与GitHub的简单介绍

Git是一个开源的分布式版本控制工具。 
GitHub是一个使用Git作为版本控制的项目托管平台，它是一个网站。 
详细请参考：http://www.cnblogs.com/cocowool/archive/2012/02/17/2356125.html

二、 Git的安装

下载地址：https://git-scm.com/download/win 或 https://git-for-windows.github.io/ 
安装时，全部默认选择即可。

三、 AS中配置Git与GitHub

1. Git的配置

在Settings设置中。 
Path to Git executable: 【Git安装后的路径】 
然后“Test”测试一下，成功才可以。 

2. GitHub的配置

Host: github.com 
Login: 【你的github用户名】 
Password: 【github登录密码】 
填好后，也进行“Test”测试一下，同样成功才可以。 

测试完后按确定，会提示你是否设置密码，看个人需求。 

四、 上传代码到GitHub

1. 创建GitHub仓库

在Github上创建一个仓库： 

创建好后，将是这个样子，里面包括一个.gitignore忽略配置文件和一个README.md

git地址如下： 

2. 创建Git本地仓库

选择工程 —— VCS —— …… 

此时，VCS的5个图标显示出来了，且要提交的文件名都是暗红色 

3. 把工程add添加到仓库

选择工程 —— 右键 —— Git —— Add 

Add后待提交的文件名是绿色

4. commit提交

CommitMessage：填入提交说明信息。主要用于说明你做了哪些修改。

按Commit提交即可。 
注：我每次都无法提交，commit后，进度对话框走到一半就立马消失了。解决办法见下面常见问题的“无法commit”。 
提交后的文件颜色是灰白色。修改过的文件时淡蓝色

5. push推送到GitHub

Commit后会自动弹出Push推送窗口，点“Define remote”。 
Name：默认origin 
URL：就是github的网页地址，上面已提供获取方法 

上面的界面操作，等同于Git Bash中使用命令： 
git remote add origin https://github.com/zjun615/GitHubTest.git

然后“OK”再“Push” 
注：我这里的Push也会出问题，见下面的解决方法 

刷新github后，就能看到上传的工程文件： 

五、 常见问题

1. 无法commit

因为会检查代码，就算没有错误，只有警告它也会让你无法提交。不会像单个文件的提交一样，提示你选择Review还是继续commit。所以就取消提交页面的“Perform code analysis”选项 

2. 无法push推送

• 现象： 
  Push的时候，弹出错误信息：Push rejected，Push to origin/master was rejected 
   
  控制台输出的详细错误信息： 
  

• 原因： 
  通过上述错误信息，告诉我们github中有我们本地没有的文件，需要先pull。在VCS —— Git —— Pull 
  

  Pull也会报错：Git Pull Failed，fatal: refusing to merge unrelated histories 
  

  

  也就是说直接pull也是不行的。并提示拒绝合并两个不相关的仓库

• 解决办法： 
  打开Git Bush。本地资源管理器的工程目录下，右键——Git Bush Here。或直接打开Git Bash，然后用cd命令打开工程目录。 
  输入命令：git pull origin master –allow-unrelated-histories 
  表示允许不相关的仓库合并。 
   
  此时，你可以看到工程中多了两个github中的两个文件 
  

  其中.gitignore文件是还没有添加的，需要添加然后提交。 
  添加命令：git add .gitignore 
  提交命令：git commit 
  

  添加后提交，会弹出提交的提示信息： 
   
  这里是VIM文本编辑器让你提交。操作命令： 
  进入到输入状态：按i键 
  从输入状态退出：Esc键 —— Shift+;键 —— wq!(保存并退出)或q!(不保存退出) —— Enter

  最后使用提交，命令：git push –u origin master 
   
  上面信息代表上传成功，去github看看就知道了。

  此问题困扰了我很久才解决，最主要的就是这条命令： 
  git pull origin master –allow-unrelated-histories 
  其他的命令都可以在界面上操作。 
  参考：http://stackoverflow.com/questions/37937984/git-refusing-to-merge-unrelated-histories

 如果pull不成功，可以删除本地.gitignore文件，从github上面获取，然后在push

3. 取消工程与Git的关联

在本地项目工程下有一个.git文件夹，删除即可。