GitHow-ToBeginner · 3 min read

How to Use git switch: Simple Guide to Change Branches

Use the git switch command to change branches in your Git repository. For example, git switch branch-name moves you to an existing branch, and git switch -c new-branch creates and switches to a new branch.

📐

Syntax

The git switch command helps you move between branches or create new ones. Here are the main parts:

git switch <branch-name>: Switch to an existing branch.
git switch -c <new-branch-name>: Create a new branch and switch to it.
git switch -C <branch-name>: Force create or reset a branch and switch to it.

bash

git switch <branch-name>
git switch -c <new-branch-name>
git switch -C <branch-name>

💻

Example

This example shows how to switch to an existing branch and how to create and switch to a new branch.

bash

$ git switch feature
Switched to branch 'feature'

$ git switch -c new-feature
Switched to a new branch 'new-feature'

Output

Switched to branch 'feature' Switched to a new branch 'new-feature'

⚠️

Common Pitfalls

Common mistakes include trying to switch to a branch that does not exist without using -c, or confusing git switch with git checkout. Also, forgetting to commit or stash changes before switching can cause errors.

Always save your work before switching branches.

bash

$ git switch missing-branch
error: pathspec 'missing-branch' did not match any branch

# Correct way to create and switch:
$ git switch -c missing-branch
Switched to a new branch 'missing-branch'

Output

error: pathspec 'missing-branch' did not match any branch Switched to a new branch 'missing-branch'

📊

Quick Reference

Command	Description
git switch	Switch to an existing branch
git switch -c	Create and switch to a new branch
git switch -C	Force create/reset and switch to a branch
git switch -	Switch to the previous branch

✅

Key Takeaways

Use git switch to change branches safely and clearly.

Add -c to create a new branch and switch to it in one step.

Always commit or stash changes before switching branches to avoid errors.

Use git switch - to quickly go back to the last branch.

Remember git switch is simpler and clearer than git checkout for branch switching.