Create a new Git branch from the web – Azure Repos

Create a new Git branch

Trong bài viết này

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018

Visual Studio 2022 | Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015

The first commit in a new Git repo is the start of the main branch. As you work in the main branch, you make commits to record your work in that branch. Branching in Git occurs when you create a new line of development that diverges from a prior branch. You might choose to create a new branch to develop and test a new feature before adding it to your main branch. The recommended Git workflow is to use a new branch for every feature or bugfix. When you switch between branches, Git almost instantly switches the version of your repo files to match the branch you selected. Your commits are always saved to the current branch, and are isolated from commits in other branches.

For an overview of the Git workflow, see Azure Repos Git tutorial.

Create a new branch

Note

Branch names can’t contain ASCII control characters, such as spaces, tildes, and colons. It’s common practice to use lowercase characters and to separate words with a hyphen. Forward slashes can be used to group branches. Branch name length shouldn’t exceed 250 ASCII characters. To avoid ambiguity between branch names and commit hashes, don’t use branch names that consist of 40 hexadecimal characters. For more information on branch naming, see git-check-ref-format and Git cross-platform compatibility.

  • Browser
  • Visual Studio 2019
  • Visual Studio 2017 & earlier
  • Git Command Line

You can create branches in Azure Repos Git repos, GitHub repos, or other hosted Git repos.

Azure Repos

  1. From your web browser, open the team project for your Azure DevOps organization, and then choose Repos > Branches to open the Branches view.

    Screenshot of the Azure DevOps project page with the Repo menu expanded.

  2. In the Branches view, choose New branch to launch the Create a branch dialog.

    Screenshot of the 'New branch' button on the Azure DevOps repo page.

  3. In the Create a branch dialog, enter a unique new branch name, select a base branch for your new branch, optionally link work items, and then choose Create.

    Screenshot of the 'Create a branch' dialog.

    Your new branch shows up in the branch list.

    Screenshot of the branch list that shows your new branch.

GitHub

From your web browser, navigate to the main page of your GitHub repo, select a base branch to launch the Switch branches/tags dialog, enter a unique new branch name, and then choose Create branch.

Screenshot of the 'Switch branches/tags' dialog on the main page of a GitHub repo.

The main page of your repo now shows the files in your new branch.

Screenshot of your new branch files on the main page of a GitHub repo.

  1. View your repo’s branches by selecting Repos > Branches while viewing your repo on the web.

    View your branches

  2. Select New branch in the upper-right corner of the page.

    Create branch button

  3. In the Create a branch dialog box, enter a name for your new branch, select a branch to base the work off of, and associate any work items.

    Screenshot that shows the creation of a branch with the new branch dialog.

  4. Select Create branch.

  1. View your repo’s branches by selecting Branches while viewing your repo on the web.

    Branches page.

  2. Select New branch in the upper-right corner of the page.

    Create branch button.

  3. In the Create a branch dialog box, enter a name for your new branch, select a branch to base the work off of, and associate any work items.

    Create a branch with the new branch dialog.

  4. Select Create branch.

Tip

After you’ve created a remote branch, you can fetch it into your local Git repo. At the command prompt, run:
git fetch
git switch <remote branch name>

Visual Studio 2019 version 16.8 and later versions provides a Git version control experience while maintaining the Team Explorer Git user interface. To use Team Explorer, uncheck Tools > Options > Preview Features > New Git user experience from the menu bar. You can use Git features from either interface interchangeably. Below, we provide a side-by-side comparison of how to create a branch.

Visual Studio Git

  1. From the Git menu on the menu bar, choose New Branch to open the Create a new branch window.

Screenshot of the 'New Branch' option in the Git menu in Visual Studio 2019.

  1. In the Create a new branch window, enter a descriptive branch name to let others know what work the branch contains. By default, Visual Studio creates your new branch from the current branch. The Checkout branch checkbox automatically switches you to the newly created branch. Select Create.

Screenshot of the 'Create a new branch' window in Visual Studio 2019.

Visual Studio Team Explorer

  1. In Team Explorer, select the Home button and choose Branches.

Screenshot showing the Branches option in Team Explorer in Visual Studio 2019.

  1. Right-click the default branch, often named main, and then choose New Local Branch From

Screenshot of the 'New Local Branch From' menu option in the context menu of the main branch in Visual Studio 2019.

  1. Enter a descriptive branch name to let others know what work the branch contains. Select Create Branch.

Screenshot of the branch name text and 'Create Branch' button in Visual Studio 2019.

Visual Studio 2015 & 2017

  1. Open up Team Explorer and go to the Branches view.

  2. Right-click the parent branch (usually main) to base your changes and choose New Local Branch From….

  3. Supply a branch name in the required field and select Create Branch. Visual Studio automatically performs a checkout to the newly created branch.

    Creating Git Branches in Visual Studio.

To create a new branch, use the git branch command. This command doesn’t switch your current branch to the new branch.

git branch <new branch name>

To switch to a branch, use the git checkout command.

git checkout <existing branch name>

To create and switch to a branch in one command, use the git checkout command with the -b flag.

git checkout -b <new branch name>

Tip

You can also use git switch <existing branch name> to switch to a new branch. Or, to create and switch to a new branch in one command, use git switch -c <new branch name>.

Next steps