Git Tips

In the last seven months I learned git, working for a dozen of projects. On some of them I was the master&commander, on others I only set up the streams and let the young Jedi find the way to the delivery. Via trial and error I find out a bunch of userful commands.

I present here in order of priority, from the most important to the least...let's start

 Userful monitoring / configuration  commands

  1. This is the first tip I suggest you:
    git config --global merge.ff false
    This configuration force git to register a commit object even if the merge is a fast forward merge. Git has a "smart" what of acting, consisting in not registering fast-forward merges. This can be very annoying if you try to track down an evil sith commiting random stuff on your system. Belive me. Sith are so evil!
  2. Find out what happen while you was on holidays...
    git whatchanged master...my/great-release
    It is the most userful command to check differences between branches/tag/commits. If you have a huge project, you can also specify a directory like in
    git whatchanged  master...my/great-release test-scripts-dir
    The standard report is quite good, listing commit comment, and files. Even better if you want to recover the previous file's version,  issue
    git show HEAD^1:parser/src/main/MyStuff.Java >OldStuff.java
    #For two version before try...
    git show HEAD^2:parser/src/main/MyStuff.Java
  3. Resync with remote is always a pain if you forget a branch...
    git remote update
    Without special configuration, this command will fetch updates for all your remotes. Very useful if you need to know the status of all your branches
  4. Logs are good, but logs with branch description are better:
    git log --decorate
    Will show you also the branches or the tag
  5. Sometimes you need to erase what you have just commited. An easy way to do it  is
    git reset --soft HEAD^
    This will revert your last commit, leaving it as "Changes to be committed". Very userful if you do a wrong merge. For instance, if you are on branch "stable" and issue

    git pull origin instableStuff

    you will wrongly issue a merge of the  instableStuff into your stable branch. It is quite subtle. Sometimes there is a better option. It is called "revert":

     git revert HEAD

    is better because will register a "revert" commit on the history, and it is useful when you already pushed your deadly stuff.

    UPDATE2019 git revert remove added files too, recording as deletion. It is quite a dangerous way-of-life: do not use revert to rollback a merge from branch X, if you plan to merge X again after a while. This because git will happily remember the deletations, and will not show the file in a subsequent merge  (if not modified). Keep an eye on your merge if a revert was done and use "merge --abort" to abort a merge.

    Why I do not like a lot git reset way of life.
    Git reset can "erase" history, anyway, "git reflog" will keep in the trashcan the old commit, in case you need it. But be careful,because reflog is compacted from time to time so it is not a safe place

Team Caffeine Stats

git shortlog -s -n
Will give you fast stats on your team: if someone has a very huge commit rate, reduce free coffe meetings to give him some rest :)

Useful scripting commands

git ls-files
can be used with xargs to kill all your nasty binaries.
For instance
git ls-files workarea/workspace103 | grep /classes/ | xargs git rm
will save your days

Nice to know advices

  • Git 1.7.10 supports utf-8 encoding. I strongly encoruage you to use it instead of older version.
  • --dry-run option It is your best friend during a pull or a risky commit. Even if you are better then Yoda (or Linux) at git, you should definitely try it out sometimes.
  • git pull --rebase
    It should avoid merge linearizing input history. I am not sure it is a good idea, but can avoid repeating merges if you needn't. Anyway, do a lot of testing before proceeding in this way.

Subversion to Git migration guide

This Good article
http://john.albin.net/git/convert-subversion-to-git
will save your days.

Known weird errors

  • can't resolve proxy 'null' for https Do a
    $git var -l | grep http
    http.sslcainfo=/bin/curl-ca-bundle.crt
    http.proxy=
    If you have  the empty http.proxy config, here is the problem.

    Do a look at your $HOME/.gitconfig for the blank http.proxy  configuration, and zap it.

Here you can find other tips. Hub is a replacement script for git, but I disagree with this approach: anyway, you can decide by yourself if it deserve your attention.

Comment by daitangio on 2013-05-14 11:30:33

To recover a delted file, the fastest way is decipted here http://stackoverflow.com/questions/953481/restore-a-deleted-file-in-a-git-repo and in summary is git checkout $(git rev-list -n 1 HEAD -- "$file")^ -- "$file"