Use gitk to understand git

Posted by Joshua Flanagan on September 3, 2010

Moving from subversion to git can be a struggle, trying to understand what terms like checkout, commit, branch, remote, rebase all mean in the git world. I learned by experimenting in a demo repository, trying out various commands, and using gitk to visualize their impact. This post is broken up into two parts – after reading this, you may want to read the second part.

The gitk screen

I created a simple repository on github to walk through some scenarios. I’ll start by creating a local copy of the repository:

d:code>git clone [e-mail]:joshuaflanagan/gitk-demo.gitInitialized empty Git repository in d:/code/gitk-demo/.git/remote: Counting objects: 9, done.remote: Compressing objects: 100% (4/4), done.remote: Total 9 (delta 0), reused 0 (delta 0)Receiving objects: 100% (9/9), done.d:code>cd gitk-demod:codegitk-demo>gitk --all

There is a lot of information in this single screenshot:

1. The upper left pane shows the series of commits to this repository, with the most recent on top.
2. There have been three commits, all by Tony Stark.
3. The commit message for the most recent commit was “third commit”
4. There is a single local branch, named “master’”, it points to the most recent commit
5. There is a single remote reference branch: the “master” branch from the remote repository named “origin”, it also points to the most recent commit
6. The yellow dot next to the top commit indicates that is the snapshot currently in my working folder (referred to as HEAD)
7. I’ve highlighted the second commit, so that I can see its details in the lower pane
8. The commit SHA (unique identifier, similar to subversion revision number) of the second commit is 3d024dd9e4a83d8c6a9a143a68b75d4b872115a6
9. The lower right shows the list of files impacted by the second commit
10. The lower left shows the commit details, including the full diff
11. Clicking a file in the lower right pane scrolls the diff in the lower left pane to the corresponding section

A note about “master” and “origin”

When you first create a git repository, it starts with a single branch named “master”. There is nothing special about this branch, other than it is the default. You are free to create a new one, and delete master (although, I don’t see any reason to go against the default convention).

When you first clone a git repository, git will automatically create a remote for you named “origin”. A remote is just a name used to manage references (URLs) to other repositories. There is nothing special about the “origin” remote, other than it is created for you. You are free to create a new one and delete origin. In fact, if you are working with multiple remotes, I recommend you delete the origin remote and create a new one for the same repository, but using a more descriptive name. For example, when I work with the FubuMVC source code, in my local repository I have a remote named “darth” which refers to the main repository owned by DarthFubuMVC, and a remote named “josh”, which refers to my fork. If I had kept the name “origin”, I would always have to remember which one I cloned from.

Branching

What happens when I create a branch?

d:codegitk-demo>git branch issue123

Press CTRL-F5 in the gitk window to refresh the repository view

We see the new branch marker for the issue123 branch points to the same commit as master and origina/master. It is important to note that the “master” is bold, indicating that is still the current branch. The bold branch label is equivalent to the asterisk in the command line output:

d:codegitk-demo>git branch  issue123* master

Now if I switch to the new branch and refresh gitk:

d:codegitk-demo>git checkout issue123Switched to branch 'issue123'

(We’re going to focus on information in the top pane from now on, so I’ll hide the bottom part of gitk)

Note: For convenience, I could have created and switched to the new branch in a single command: git checkout –b issue123

Making changes

When I refer to the “current branch”, I mean “the branch that will advance when I perform a commit”. This is where the gitk visualization really starts to help. I’ll make some changes to a file and then commit with the message “My first commit”:

d:codegitk-demo>git commit -am "My first commit"[issue123 f948bf8] My first commit 1 files changed, 2 insertions(+), 1 deletions(-)

The issue123 branch now points to my new commit. Neither the master nor origin/master branch pointers have moved.

As I continue to commit, the current branch pointer moves with me:

d:codegitk-demo>git commit -am "Added another fruit"[issue123 cac3c72] Added another fruit 1 files changed, 1 insertions(+), 0 deletions(-)

But I thought it was a branch

Since I was working in a branch, I expected to see a tree stucture, with nodes turning off from the main “trunk”. Something like this:

Instead, gitk shows all of the commits as a single straight line. When first using git, this was very confusing to me. My confusion stemmed from my misunderstanding of branches in git. Thinking about why gitk was showing all of the commits in a straight line finally brought the point home. In git, a branch is a label for a commit. The label moves to new commits as they are created. When you create a git branch, you are not changing anything in the structure of the repository or the source tree. You are just creating a new label.

Fast forward

After completing my work in the issue123 branch, I’ll want to merge the changes back into master. Usually when I think of a merge, I think of comparing two trees and applying the differences from one onto the other. I imagine each commit being replayed on the other branch. Merging issue123 into master would require applying each of my two commits to the master branch. However, this work has already been done, when I first performed the commits. Because the master label hasn’t moved since my work began on issue123, applying the diffs would end up with the same result. This is where the “single straight line” visualization really proves valuable – I can see that issue123 is directly ahead of master. Git is smart enough to recognize this situation and performs what it calls a fast-forward merge. A fast-forward merge isn’t really a merge at all – since no file content comparisons are necessary – it simply moves the master branch label up to point to the commit pointed at by the issue123 label.

To merge the changes from issue123 into master, I first checkout (switch to) the master branch and then do the merge:

d:codegitk-demo>git checkout masterSwitched to branch 'master'

 

d:codegitk-demo>git merge issue123Updating bf37c64..cac3c72Fast-forward fruits.txt     |    1 + vegetables.txt |    3 ++- 2 files changed, 3 insertions(+), 1 deletions(-)

A few things to notice:

• The command-line output indicated the merge was a “Fast-forward”.
• A new commit was not created. There is no new snapshot of the repository required, since there is no new version of any files/folders that didn’t already exist in the repository.
• The remote origin/master branch has not moved. Everything we’ve done so far (except for the initial clone) has run completely locally, without contacting the github server.

Deleting a branch

The issue123 branch label is now redundant, since it points to the same commit as master. If there is no more work to do for issue123, we can safely get rid of the branch, without losing any historical information. If we later find out we need to make some changes to solve the issue, we can always create another branch (which is just a label). This is what it means when people say that branching in git is easy or lightweight.

d:codegitk-demo>git branch -d issue123Deleted branch issue123 (was cac3c72).

Sharing with the world

As noted above, everything we’ve done so far has been in our local copy of the repository. The “master” branch at the “origin” remote has not moved. If I look at the github page for the repo, I can confirm that none of my commits exist.

To copy changes from my instance of the repository up to github’s servers, I need to push from my master branch to the “master” branch of my remote named “origin”.

d:codegitk-demo>git push origin masterCounting objects: 9, done.Delta compression using up to 2 threads.Compressing objects: 100% (4/4), done.Writing objects: 100% (6/6), 609 bytes, done.Total 6 (delta 0), reused 0 (delta 0)To [e-mail]:joshuaflanagan/gitk-demo.git   bf37c64..cac3c72  master –> master

Take note of the SHA1 ID of the latest commit, cac3c723…. Look back at the previous screenshots and notice that this identifier has not changed through all of the operations (merge, deleting the branch, etc). When we refresh the github page, we can see it has updated with all of the work I did locally. Notice the commit identifier on the web page matches up with the SHA1 ID we see locally. Also, there is no indication that any of the work was done on a separate branch – nobody ever needs to know. You are free to branch as much as you want locally without impacting a shared repository.

粘帖一些命令

1. git add 添加文件到staged area.
2. git commit 会commit staged file ，有几个选项比较重要：-a 跳过staged area,直接commit，后面加文件名也会使那个文件跳过stage，直接commit。但是前提是文件已经在index中了，新文件不会自动加入。
3.git status 查看从上次commit到目前的变化，git diff会更详细，但是它只包含应该要包含在staged area中却还未包含进去的变化，git diff --staged则列出来从上次commit到staged area的变化。
4. .gitignore文件可以设置哪些文件被排除进去，通常可以设.o, .a等文件。
5. git rm 用来remove文件。
6. git mv可以用来重命名文件。
7. git log用来查看日志，git log -p查看详细，gitk 是个图形化的查看工具。
8.Unstaging a Staged File可以用git reset HEAD <file>。 Unmodifying a Modified File可以用git checkout -- <file>。 git commit --amend用来取消上次的commit。
9. git remote显示所有的remote(加-v显示详细信息)。 git remote add [shortname] [url]用来添加remote。git fetch [remote-name]只会pull下来全部的更动，但不会自动merge，但是git pull会自动merge。 git remote show [remote-name]可以看到一个remote的详细信息。 git remote rename用来改变一个remote的名字。 git remote rm删除一个remote。
10.git tag列出所有的tag。git show tag-name可以查看tag详细信息。git tag [-a] tag-name -m message [commit-checksum]如果有-a 就添加一个annotated tag，如果没有-a，就添加一个lightweight tag,如果后面要在某个commit之后添加一个tag，就加上checksum好了。 git push有个选项 --tags会把tags信息也push上去。

11. git branch testing添加一个testing的branch. git checkout testing切换到testing branch. 
12. 切换branch的时候，当前的branch不能有和要切换过去的branch冲突的uncommitted changes.
13. git merge branch-name 将branch-name merge到当前branch.如果有conflict，可以用status查看状态，解决conflict之后用add 通知git已经解决。然后用commit commit the merge。
14.   git branch -d branch-name,但是这个branch必须被全部merge到HEAD中了。如果选项是-D的化，就不管它的merge status了。
15. git branch --merged只显示被HEAD完全包含的branch，--no-merged只显示没被HEAD完全包含的branch。
16. git push (remote) (branch)把本地某个branch push到remote上去。 git push (remote) (local-branch-name):(remote-branch-name)可以把本地branch push到remote branch上去。
17.git fetch 下载下来的branch不能edit，必须要手动merge到本地branch之后才可以edit。   $ git checkout -b local-branch-name remote-name/remote-branch-name 可以把server上的branch下载下来，并且可以直接edit。
18. Tracking Branches里面可以不必在pull和push后面加remote参数。git branch -r列出remote tracking branches.
19. git push [remotename] :[remote-branch]删除掉某个remote branch。
20. rebase可以获得和merge一样的效果，但是log记录更好，因为看起来没有分支。 git rebase --onto newbase upstream branch会把从upstream到branch的改动rebase到newbase上去。git rebase basebranch topicbranch会把topicbranch rebase到basebranch上。
21. Do not rebase commits that you have pushed to a public repository.
22.git fetch默认会获取repo所有branch的进度，除非指定哪个branch。git push可以将某个branch push到repo中去。