

To begin an interactive rebasing session, pass the i option to the git rebase command: git checkout feature Typically, this is used to clean up a messy history before merging a feature branch into master. This is even more powerful than an automated rebase, since it offers complete control over the branch’s commit history. Interactive rebasing gives you the opportunity to alter commits as they are moved to the new branch. And, less importantly, rebasing loses the context provided by a merge commit-you can’t see when upstream changes were incorporated into the feature. If you don’t follow the Golden Rule of Rebasing, re-writing project history can be potentially catastrophic for your collaboration workflow. This makes it easier to navigate your project with commands like git log, git bisect, and gitk.īut, there are two trade-offs for this pristine commit history: safety and traceability. Second, as you can see in the above diagram, rebasing also results in a perfectly linear project history-you can follow the tip of feature all the way to the beginning of the project without any forks. First, it eliminates the unnecessary merge commits required by git merge. The major benefit of rebasing is that you get a much cleaner project history. But, instead of using a merge commit, rebasing re-writes the project history by creating brand new commits for each commit in the original branch. This moves the entire feature branch to begin on the tip of the master branch, effectively incorporating all of the new commits in master.

The Rebase OptionĪs an alternative to merging, you can rebase the feature branch onto master branch using the following commands: git checkout feature

While it’s possible to mitigate this issue with advanced git log options, it can make it hard for other developers to understand the history of the project. If master is very active, this can pollute your feature branch’s history quite a bit. On the other hand, this also means that the feature branch will have an extraneous merge commit every time you need to incorporate upstream changes. This avoids all of the potential pitfalls of rebasing (discussed below). The existing branches are not changed in any way. Merging is nice because it’s a non-destructive operation. This creates a new “merge commit” in the feature branch that ties together the histories of both branches, giving you a branch structure that looks like this: Or, you can condense this to a one-liner: git merge master feature The easiest option is to merge the master branch into the feature branch using something like the following: git checkout feature To incorporate the new commits into your feature branch, you have two options: merging or rebasing. Now, let’s say that the new commits in master are relevant to the feature that you’re working on. This results in a forked history, which should be familiar to anyone who has used Git as a collaboration tool. Both of these commands are designed to integrate changes from one branch into another branch-they just do it in very different ways.Ĭonsider what happens when you start working on a new feature in a dedicated branch, then another team member updates the master branch with new commits.

The first thing to understand about git rebase is that it solves the same problem as git merge. In this article, we’ll compare git rebase with the related git merge command and identify all of the potential opportunities to incorporate rebasing into the typical Git workflow. The git rebase command has a reputation for being magical Git voodoo that beginners should stay away from, but it can actually make life much easier for a development team when used with care.
