文档
关于git的教程和手册网上很多, 但很多写的都不好.最推荐:
Git Workflow (这里的diagram非常给力)
How to version projects with Git 图文并茂,有木有?
git quick reference
这几个也不错
Git Magic 中文,英文
Pro Git(中文)
其他的还有:
Understanding Git Conceptually
Git User Manual写的比较晦涩
Git - SVN Crash Course. 我觉得帮助不是很大, 因为git和svn在用法上区别是在太大了
GIT cheat sheet这个不错
Basic Branch Merging
关于stash, log, 以及gitconfig的用法
用法
初始化一个workspace
从远端克隆一个repository到本地
$git clone git://path/to/your/git/repo注意git是一个分布式的版本控制系统. 如果你从server1上clone的repo, 那么以后server1就相当于你的源.如果以后server2再clone了你的repo, 你就相当于server2的源.我发现这种结构很方便调试 -- 在其他机器上可以从我本地repo来pull 文件. clone的时候除了git协议还可以使用ssh, 比如
$git clone ssh://hostname/path/to/your/git/repo
工作流程
进入你的工作目录,通常大家首先将本地repository更新到源上的最新版本(大致相当于svn update, 但是因为git是分布式的设计,更新到源上最新未必是全局最新). 下面的命令从origin 这个remote 更新 master这个branch的update.
$git pull origin master未必需要从自己所在的branch来更新. 比如你实际在master这个branch, 你也可以更新branch foo的东西,即使你还是留在master这个branch里:
$git pull origin foo有时候每次都是默认同样的remote同样的branch,那么我们可以修改工作目录下的.git/config文件,
[branch "master"]
remote = origin
merge = refs/heads/master
这样就可以直接用下面命令来更新而无须指定remote和branch$git pull
做了修改后, 为了查看当前工作目录的状态,比如哪些文件被改动, 哪些文件没有commit, 可以使用status (大致相当于svn st)
$git status如果需要git status的时候忽略某些文件,比如.o文件或者.pyc文件, 我们可以在.gitignore这个文件中加入两行*.o以及*.pyc.
修改了本地的文件后, 需要将其用add命令将其加入index. svn里没有index的概念,而且add这个命令在svn中是将一个文件加入版本控制. 而git里, 一个文件每次的修改都会需要你用add加入index后才能commit.
$git add file1 file2然后将index的修改commit到本地.
$git commit file1 file2 -m "go! commit file1, file2"以上两步(add, commit)也可以被合并成一步
$git commit -a file1 file2 -m "go! commit file1, file2"如果需要更改上一次commit的信息
$git commit --amend -m "this is the right commit!"
这个时候文件只是在本地commit, 如果希望更新到远端的repositiory中, 还需要push(和更新源到本地的pull命令对应). 默认git push的话是push到origin的master分支
$git push你也可以指定remote repo以及branch
$git push repo5 branch12如果当前工作目录下checkout了多个branch, 但是你一般只会push正在tracking的这个branch,可以在config文件(比如.git/config)里设置
[push]
default = tracking
或者使用命令$git config push.default tracking
提取给定版本 checkout
checkout最新commit里的foo
$git checkout foo如果需要提前两个版本的foo,可以
$git checkout HEAD~2 foo从最新的stash(stash@{0})里checkout foo这个文件
$git checkout stash@{0} foo
撤销更改 revert, checkout, reset
比如你刚刚修改了一个文件foo, 但现在想撤销这个更改. 这需要根据foo的状态来选择不同的方法:
- Changed but not updated: 如果一个文件foo被删除了, 或者被修改了但完全还在本地workspace中,还没有使用git add把foo加入index当中, 那么我们只需要重新checkout 这个文件
$git checkout foo
如果你不幸有一个branch也叫foo
$git checkout -- foo
如果你需要恢复当前目录所有文件
$git checkout .
有时候需要把当前workspace中所有的修改都撤销,可以简单的使用:
$git stash
- Changes to be committed: 这时候修改已经加入index当中,但是还没有commit 提交到本地repo,我们可以使用reset使的当前workspace回到上一个commit的时候, 然后使用checkout恢复修改.
$git reset HEAD foo $git checkout foo
撤销所有index当中的修改:
$git reset HEAD
- 如果已经使用git commit把修改提交到了本地repo当中, 我们可以把本地repo rollback到上一次commit前的状态:
$git reset --hard HEAD~1
--hard选项会overwrite的所有的改动.
如果我们只需要undo某一次的commit,可以使用git revert:
$git revert b38155cbf671d55ceb027687c39508de8cef2463
这样实际上是提交了另一个commit来抵消指定的commit.
查看日志 log
当前branch的commit日志
$git log当前branch的commit日志,显示内容
$git log -p当前branch的commit日志,但只显示上3次提交的内容
$git log -3当前branch的commit日志,但只显示被修改的文件名
$git log --name-only
处理冲突 conflict
参考手册http://www.kernel.org/pub/software/scm/git/docs/user-manual.html
以及 http://www.kernel.org/pub/software/scm/git/docs/git-push.html
pull的时候如果有本地修改会导致无法成功. 如果希望能把远端的commit merge到本地
$git checkout -m foo Auto-merging foo有可能会失败,这时候就需要你手动来编辑这个文件来merge了
push的时候, 当前commit到远端repo的时候,有时候会出现如下问题:
$git push To git@example.come:example.git ! [rejected] master -> master (non-fast-forward) error: failed to push some refs to 'git@example.com:example.git' To prevent you from losing history, non-fast-forward updates were rejected Merge the remote changes before pushing again. See the 'Note about fast-forwards' section of 'git push --help' for details.这是由于你的工作目录没有update到最新的版本.换言之有人在你上一次pull之后又push了新的commit进去.所以如果你的push生效, 可能会导致别人push的commit失效. 解决方法有两种:
$git pull $git push这种方法先把当前工作目录更新到最新 -- 这一步可能会产生冲突. 解决冲突后把更新提交. 这种方法会产生两个commit信息. 一次是说你自己的更新,另一次是将你的分支和repo上分支的merge.
如果不希望产生两次commit信息, 可以用第二种方法:
$git pull --rebase $git push这种方法直接将你的commit重新rebase到最新的版本上, 然后再进行提交.
分支 branch
一个repo可以有不同的分支,branch命令查看本地已有的分支, *表示当前使用的branch
$git branch * master testbranch可以用branch -r 查看remote所有的分支
$git branch -r也可以用branch -a 同时查看local和remote所有的分支
$git branch -a以当前branch的HEAD为起始点,新建新的branch叫newbranch
$git branch newbranch也可以指定起始点(比如testbranch), 创建一个新的分支叫newbranch
$git branch newbranch testbranch
将当前分支从master切换到testbranch
$git checkout testbranch $git branch master * testbranch
删除一个local的branch
$git branch -d branch_to_delete删除一个remote的branch
$git branch push origin --delete branch_to_delete远端 remote
查看当前branch有哪些remote
$git remote origin查看当前branch有哪些remote,显示具体一些的信息
$git remote -v origin git@example.com:bar.git (fetch) origin git@example.com:bar.git (push)
查看origin这个remote的具体信息
$git remote show origin一个repo可以有多个remote.比如给分支branch_foo添加一个新的remote:
$git remote add branch_foo git@host-for-new-remote:repo-name.git将新添加的remote添加为tracking的branch
$git branch --set-upstream branch_foo remote_bar/branch_foo
查看历史版本
查看某个版本(some-sha1)的某个文件
$git show some-sha1-number:some-file查看某个版本(some-sha1)的和最新版本(HEAD)之间的所有区别
$git diff some-sha1 HEAD查看某个版本(some-sha1)的和最新版本(HEAD)之间的某个文件的区别
$git diff some-sha1 HEAD --somefile
比较当前branch和另外一个branch比如叫foo的区别
$git diff foo比较branch foo和另外一个branch bar的区别
$git diff foo bar查看远端repo里的文件
查看当前HEAD中所有加入git管理的个文件
$ git ls-tree -r HEAD
其他相关工具
tig - text-mode interface for git 设置git ignore的方法: http://help.github.com/ignore-files/
