Git Switch Command: How to Change and Create Branches

Branch switching in Git means adjusting your working directory so that it matches the state of a chosen branch. When you move to another branch, Git aligns the files in your working directory with the snapshot of the target branch. This happens by moving the "HEAD" pointer, which marks the branch you are currently on. This setup lets you easily shift between different development contexts without losing your work. This guide explains how to use the git switch command for switching between local and remote branches.

The Short Answer Version

If you already know Git and only need a quick overview of branch switching commands, here they are:

# Switch to an existing local branch
$ git switch <branch_name>

# Create and switch to a new branch
$ git switch -c new_branch_name

# Switch to a remote branch
$ git switch -c branch_name origin/branch_name

Continue reading for detailed explanations and usage examples.

Switch Branches in Git

This section gives an in-depth look at the git switch command.

Command Explanation

The git switch command (available starting with Git 2.23) changes your working directory so that it reflects the state of the target branch.

Command Syntax with Breakdown

The general syntax to switch to the main branch is:

git switch <branch-name>

Explanation of parts:

• git switch: The command that initiates the branch change.
• <branch-name>: The branch you want to switch to.

Command Flags

You don’t need extra flags to switch to an existing branch like main. But here are useful ones:

• -f or --force: Forces the switch and discards uncommitted changes (may cause data loss).
• --merge: Attempts to merge current branch changes into the new branch.
• --detach: Moves you into a detached HEAD state at the target commit.

Command Demonstration

Example of switching to the main branch:

Check which branch you are currently on:

$ git branch

Sample output:

  feature-login
* hotfix-header
  main

Here, you’re on hotfix-header (marked with the asterisk).

Switch to the main branch:

$ git switch main

Output:

Switched to branch 'main'
Your branch is up to date with 'origin/main'.

Confirm you are now on main:

$ git branch

Output:

  feature-login
  hotfix-header
* main

The asterisk has moved, showing you are on the main branch.

Switch to a New Branch

Create and switch to a new branch with one command:

$ git switch -c <new_branch_name>

The -c (or --create) flag creates and switches to a new branch. Other useful options:

• -C or --force-create: Creates or resets the branch if it already exists.
• --track: Sets up tracking info for the branch.
• --no-track: Explicitly avoids setting up tracking info.

Switch to a Remote Branch

Remote branches exist on repositories hosted elsewhere and may need fetching before use. When collaborating, it’s common to switch to a remote branch by creating a local tracking branch that follows it.

First, update your local repository to include all remote branches:

$ git fetch

Create a local branch that tracks the remote one and switch to it:

$ git switch -c <branch_name> origin/<branch_name>

Explanation:

• git switch: The command to change branches.
• -c: Creates a new local branch.
• <branch_name>: Your new local branch name (usually same as remote).
• origin/<branch_name>: The remote reference.

For Git 2.23+, you can use a shorter version:

$ git switch --track origin/<branch_name>

This automatically uses the remote branch name for the local one.

Other related flags:

• --track or -t: Sets up branch tracking.
• --no-track: Prevents tracking setup.
• -c: Forces branch creation even if it exists.

Conclusion

You now know how to use git switch to move between branches in Git. You can jump to existing branches, create and switch to new ones, and connect to remote branches locally. These abilities are essential for keeping a smooth Git workflow and let you handle multiple tasks, features, or fixes effectively. For more advanced options, consult the Git documentation.