转载

Git & Github 一页简明笔记

由于小组工程需要使用git&github的版本控制来协作，但我对其使用并不熟悉，特此写篇一页的笔记放在手边，备随时查阅。

相信这种一页的简明笔记，对大家也是有帮助的。我的笔记总结自廖雪峰的Git教程（这是个链接，点进去就好^_^）。

请不怎么了解Git的同学先去看廖雪峰的教程，好好学习，因为我这里并不会陈列知识上的细节。

使用方法：常用命令供随时查阅，其余内容供新手了解。

0. 常用命令一览

# 配置仓库命令（项目名：play，项目发起者的名字：icedream61，URL=get@github.com:icedream61/play.git） git clone URL                    # 第一次克隆远程仓库，并关联：远程仓库 -> 本地仓库 git remote add origin URL        # 第一次推送本地仓库，并关联：本地仓库 -> 远程仓库（远程仓库名习惯起为origin，请入乡随俗）  ＃ 配置分支命令（分支名：dev，远程仓库名：origin） git checkout -b dev origin/dev   # 第一次克隆远程分支，并关联：远程分支 -> 本地分支 git push -u origin dev           # 第一次推送本地分支，并关联：本地分支 -> 远程分支  # 调试命令 git remote                       # 查看远程仓库名（如origin） git remote -v                    # 查看远程仓库库的名字、URL地址以及自己拥有的权限（fetch & push，即 克隆 & 推送） git branch                       # 查看本地所有分支，以及自己当前所处的分支（前面有星号） git status                       # 查看本地工作区、暂存区状态 git tag                          # 查看本地所有标签 git show <tag>                   # 查看对应标签详细信息 git log                          # 查看所有历史版本（详细信息） git log --pretty=oneline         # 查看所有历史版本（一个版本一行信息） git reflog                       # 查看所有历史操作（同样可以加单行参数，不过貌似没区别）  # 协同开发命令 git pull                         # 克隆全部远程分支：远程仓库 -> 本地仓库 git push origin <branchs>        # 推送本地分支：本地仓库 -> 远程仓库（分支名以空格分割） git push origin <tags>           # 推送本地标签：本地标签 -> 远程标签（标签名以空格分割） git push origin --tags           # 推送全部本地标签：本地标签 -> 远程标签  # 单机开发命令 git add <files>                  # 添加文件：工作区 -> 暂存区（文件名以空格分割） git add -A                       # 添加所有文件：工作区 -> 暂存区（参数-A也可以写成--all） git commit -m ".."               # 提交所有文件：暂存区 -> 本地仓库（""中的注释一定写清楚～） git checkout -- <files>          # 撤销文件在工作区的修改：暂存区 -> 工作区 git reset HEAD <files>           # 撤销文件的提交：本地仓库 -> 暂存区（就是回退到当前版本^_^） git reset HEAD                   # 撤销所有文件的提交：本地仓库 -> 暂存区 rm <files>                       # 删除工作区的文件（这个按说不算git命令=_=） git rm <files>                   # 删除暂存区的文件 git reset --hard commit_id       # 切换到指定版本（commit_id可以改成HEAD、HEAD^、HEAD^^、……，即当前版本、上一版本、……）  # 单机分支管理命令 git branch dev                   # 创建dev分支 git checkout dev                 # 切换至dev分支 git checkout -b dev              # 创建并切换至dev分支 git merge my_dev                 # 将my_dev分支合并到当前所处分支中（通过git branch命令查看当前所处分支） git branch -d my_dev             # 删除my_dev分支  # 单机标签管理命令 git tag <tagname>                # 为当前版本（HEAD指向的版本）打一个标签 git tag <tagname> commit_id      # 为指定版本（commit_id对应版本）打一个标签 git tag -a <tagname> -m ".."     # 为当前版本打一个标签，加上备注信息 git tag -d <tagnames>            # 删除本地标签（标签名以空格分割）

1. 安装Git

检查是否安装：命令行下输入git，能找到命令即可。

Mac OS X	已预置
Ubuntu	sudo apt-get install git
较老的Ubuntu 或其余Linux系统	从Git官网源码安装，详见廖雪峰的Git教程
Windows	详见廖雪峰的Git教程

Git安装之后，需要在命令行写三条命令设置下：

git config --global user.name "icedream61"                # 建议和github保持一致 git config --global user.email "icedream@sjtu.edu.cn"     # 建议和github保持一致 git config --global color.ui auto

2. 熟悉Github

首先要去 Github 上面注册一个账号，具体细节见官网。

登陆进去Github，随时点左上角的小猫头像便可以回到主页。主页上方搜索框可以搜索开源项目，四张醒目的图片是Github的官方使用教程（显然是英文），下面左侧是你所参与项目的近期动态，右侧则是你所参与的项目列表。在这里，你可以看到 +New repository 按钮，用来创建新项目的按钮。

在Github中，创建项目又叫创建项目“仓库”（repository）。因为Github一个项目就是一个存放代码的仓库，大家都可以来看代码、下载代码……

Github是允许你在线改代码的，但往往在线修改并不容易（如Android代码，显然下载到本地用IDE才是正道），因此往往大家都下载代码在本地修改，改好了传上去。下载上传代码有两种方式，一种是点按钮的，一种是命令行的，这里只介绍命令行的。

Github是基于一个叫Git的命令行工具的，这东西的历史详见廖雪峰教程开篇的Git简介。日常使用中，Github是需要和Git协同工作的，一般流程都是这样：

新建项目

上Github，新建一个项目仓库，做好基本设置，写好简介

这样，你和别人便都可以看到这个项目了

下载代码

上Github，找到项目，在页面右侧下方找到clone URL，选择传输方式（SSH最快），点击按钮复制网址

进入本地某目录（如workspace），输入命令：git clone URL（刚才的网址），选择yes

假如刚才的项目叫play，你现在本地便会多个目录workspace/play/，里面是项目的全部代码

3. 设置SSH KEY

本地Git和远程Github通信是采用ssh协议的，因此需要设置ssh密钥。

如果目录~/没有.ssh目录，则需要创建ssh密钥，命令：ssh-keygen -t rsa -C "youremail@example.com"（换成你的邮箱）

上Github，右上角点你自己的头像，选settings；左侧，选择SSH keys进入；选Add SSH key，写个Title，把~/.ssh/id_rsa.pub内容复制到文本框Key，点Add key。

搞定。

对了，给Github设置ssh密钥，你的邮箱应该会收到邮件提醒的～

4. 仓库（又称版本库）与远程仓库、版本控制、分支、标签

这几个概念必须清晰，这里只做简述，详见廖雪峰教程。

在Git中，有仓库和工作区之分。以刚才的play项目为例，你项目根目录workspace/play/便是你的工作区，而仓库则是workspace/play/.git/目录（隐藏的）。你平时工作就在工作区工作，文件随便改；想保存了，就利用Git的命令存入仓库；想恢复了，就利用Git的命令从仓库恢复，这样工作区便成了你之前保存的样子。

远程仓库，就是像Github这样的地方。本地的修改，上传到远程仓库，可以免得本地代码丢失，以及方便大家协同工作、方便发布代码。

Git会把每个版本都存一份，而HEAD指针指向当前版本。你用git clone下载的就是HEAD指针所指的版本，而你可以查看所有版本信息，可以用HEAD指向任何之前的版本，便退回去了。

Git有飞快的分支管理（比别的类git软件分支管理快得多），比如play这个项目上线了，大家开始用稳定版。而你们团队打算继续开发，有开发UI界面的、游戏内核的等等，那么你们便需要各自创建自己的分支去开发，此时你们便依旧可以正常从Github上传和下载代码，而由于所处分支不同，你们各自的开发进度、你们的开发和上线的版本都不会互相影响。等各自开发完了，再把各个分支合并起来，形成新的版本继续开发和发行。

Git有标签管理，你可以给某个版本打上独特的标签，这样以后便可以轻松定位到了。例如发行什么1.0版、2.0版，开发1.1版、1.1.3版之类的，随你喜欢。

熟练使用这些功能，可以极大提高开发效率。