1237

I started working on my master branch thinking that my task would be easy. After a while I realized it would take more work and I want to do all this work in a new branch.

How can I create a new branch and take all these changes with me without dirtying master?

5

6 Answers 6

986

If you hadn't made any commit yet, only (1: branch) and (3: checkout) would be enough.
Or, in one command: git checkout -b newBranch

With Git 2.23+ (Q3 2019), the new command git switch would create the branch in one line (with the same kind of reset --hard, so beware of its effect):

# First, save your work in progress!
git stash

# Then, one command to create *and* switch to a new branch
git switch -f -c topic/wip HEAD~3

Or, as suggested in Alia's answer, use git switch -m, without git stash:

git switch -c topic/wip -m

--merge

If you have local modifications to one or more files that are different between the current branch and the branch to which you are switching, the command refuses to switch branches in order to preserve your modifications in context.

However, with this option, a three-way merge between the current branch, your working tree contents, and the new branch is done, and you will be on the new branch.

When a merge conflict happens, the index entries for conflicting paths are left unmerged, and you need to resolve the conflicts and mark the resolved paths with git add (or git rm if the merge should result in deletion of the path).


As mentioned in the git reset man page:

$ git stash                # (0) Save your work in progress
$ git branch topic/wip     # (1)
$ git reset --hard HEAD~3  # (2)  NOTE: use $git reset --soft HEAD~3 (explanation below)
$ git checkout topic/wip   # (3)
  1. You have made some commits, but realize they were premature to be in the "master" branch. You want to continue polishing them in a topic branch, so create "topic/wip" branch off of the current HEAD.
  2. Rewind the master branch to get rid of those three commits.
  3. Switch to "topic/wip" branch and keep working.

Again: new way (since 2019 and Git2.23) to do all that in one command:

git switch -f -c topic/wip HEAD~3

Note: due to the "destructive" effect of a git reset --hard command (it does resets the index and working tree. Any changes to tracked files in the working tree since <commit> are discarded), I would rather go with:

$ git reset --soft HEAD~3  # (2)

This would make sure I'm not losing any private file (not added to the index).
The --soft option won't touch the index file nor the working tree at all (but resets the head to <commit>, just like all modes do).


16
  • 6
    It's probably also worth noting that this wouldn't be a good idea if you have committed topic material to your master branch in a repository that other people pull from. Or at least, if you do need to do a reset you'll need to tell people that's what you are doing so the warnings from their next pull aren't too much of a shock. Commented Oct 10, 2010 at 9:54
  • 63
    Note to future readers: read from bottom to top (or be sure to read the whole thing). git reset --hard will nuke your changes, and if they aren't committed yet they are unrecoverable! You may just need git checkout -b … Commented May 30, 2012 at 18:58
  • 5
    @ConradMeyer Good point. I have edited the answer and put the git checkout -b first.
    – VonC
    Commented May 30, 2012 at 19:54
  • 6
    Why topic/branch?? why not just branchname, is there a special reason for this naming? just wondering. Commented Jun 29, 2012 at 6:50
  • 3
    @It is just a namespace naming convention (a way to easily classify branches, using hierarchical branch names to define namespaces): stackoverflow.com/a/2527436/6309. For instance, for issues: randyfay.com/content/…. You don't have to use a hierarchy when namming your branches. topic_wip would work too ;)
    – VonC
    Commented Jun 29, 2012 at 7:51
432

Like stated in this question: Git: Create a branch from unstagged/uncommited changes on master: stash is not necessary.

Just use:

git checkout -b feature/newbranch

Any uncommitted work will be taken along to the new branch.

If you try to push you will get the following message

fatal: The current branch feature/newbranch has no upstream branch. To push the current branch and set the remote as upstream, use

git push --set-upstream origin feature/newbranch

Just do as suggested to create the branch remotely:

git push --set-upstream origin feature/newbranch

2
  • 4
    You'll get the 'no upstream branch' error only if you push the new branch, not when you commit the new work.
    – sam
    Commented Nov 15, 2017 at 23:59
  • 2
    @sam I've amended the answer accordingly Commented Jan 11, 2018 at 22:51
118

Follow these steps:

  1. Create a new branch:

     git branch newfeature
    
  2. Checkout new branch: (this will not reset your work.)

    git checkout newfeature
    
  3. Now commit your work on this new branch:

    git commit -s
    

Using above steps will keep your original branch clean
and you dont have to do any 'git reset --hard'.

P.S. -s parameter for commit is for --signoff

3
  • 3
    What does the '-s' do in step 3?
    – SMBiggs
    Commented Dec 11, 2015 at 16:54
  • 15
    @ScottBiggs It is unnecessary, but a practice some people follow. It is short for "--signoff" and adds your user name to the commit for future people looking at the logs to know that you condoned this commit. Commented Feb 3, 2016 at 15:46
  • 11
    Nice answer, but no need for -s in step 3. Commented Jul 18, 2016 at 16:37
48

Since you haven't made any commits yet, you can save all your changes to the stash, create and switch to a new branch, then pop those changes back into your working tree:

git stash  # save local modifications to new stash
git checkout -b topic/newbranch
git stash pop  # apply stash and remove it from the stash list
5
  • 13
    or as VonC pointed out 'git checkout -b newbranch' and skip the stash Commented Oct 10, 2010 at 15:46
  • 1
    @will: I was thinking that creating a new branch would overwrite any uncommitted changes you had, but if this is not the case, yes you can skip the stash.
    – Ether
    Commented Oct 10, 2010 at 15:58
  • 1
    I tried it and it worked fine, git is very thoughtful and wont overwrite any local changes Commented Oct 10, 2010 at 16:35
  • 2
    I assume it was a typo but just a heads up that git stash push is not a command. You would presumably want to use git stash or git stash save. If you want to include untracked files in the stash, use the --include-untracked option. Likewise, if you want to include both untracked and ignored files in the stash, use the --add option instead.
    – Six
    Commented Oct 10, 2015 at 13:43
  • in case you have created the branch already, this is helpful.
    – Surely
    Commented Mar 10, 2016 at 6:32
43

I see that the most of the answers here are outdated. There is no need to do stash and pop with the new switch command.

git switch -c new_branch -m

will create a new branch named "new_branch", switch to it it and bring along all uncommitted changes as modified files. You can then continue working on the changes or commit them to the new branch etc.

1
  • Good point. Upvoted. I have referenced your option in my own answer
    – VonC
    Commented Aug 2, 2022 at 6:26
17

To add new changes to a new branch and push to remote:

git branch branch/name
git checkout branch/name
git push origin branch/name

Often times I forget to add the origin part to push and get confused why I don't see the new branch/commit in bitbucket

Not the answer you're looking for? Browse other questions tagged or ask your own question.