Introduction
Git is a project-tracking application that creates a main project thread that can be branched.
Git branches are used to develop changes and updates without affecting the core project. Files in a branch may need to be deleted if they become corrupted or obsolete after merging branches.
This guide shows you how to delete remote and local branches in Git.
Prerequisites
- A Git project
- A user with privileges to delete files from the project
What are Git Branches?
A Git branch is a copy of the project from a specific point in time. Once changes have been made and approved, you can commit the branch changes to the main project. In some cases, it may be necessary to undo Git commits.
Note: A user can check out a branch from a previous version, make changes, then publish the update. Changes are not permanent until they are committed. Git tracks revisions through the life span of a project.
Git can span multiple systems. A central server keeps the main project files. Users can check out a project, make changes on their local system, then publish the changes back to the server.
-
-
- The files and branches on the main server are remote branches.
- The files and branches on a user’s system are called local branches.
-
Deleting a Remote Branch
A remote branch is located on a different system; usually, a server accessed by developers. Deleting a remote branch removes it for all users.
Delete a remote Git branch by entering the following command:
git push remote_project --delete branch_name
As an alternative, use the following command to delete a remote branch:
git push remote_project :branch_name
In some cases, this may generate an error that indicates that the branch has already been deleted.
Refresh the branch list before trying to delete the remote branch again:
git fetch -p
Deleting a Local Branch
A local branch is stored on the local system. Deleting a local branch does not affect a remote branch. Check out a local GIt branch that you DO NOT want to delete:
git checkout main_branch
Use the following command to delete a local branch:
git branch –d branch_name
The system confirms the name of the deleted branch.
The –d
option only works on branches that have been pushed and merged with the remote branch. To force deletion of a local branch that has not been pushed or merged yet, use the –D
option:
git branch –D branch_name
Conclusion
You now know how to delete local and remote Git branches. Learning to manage Git branches effectively is vital for developer collaboration when working on demanding projects.
Next you should also read
SysAdmin,DevOps and Development
September 15, 2020
Unstaging in Git means removing queued changes from the index. This guide covers several different ways to…
SysAdmin,DevOps and Development
March 10, 2020
Git, the popular version control system, has a plethora of commands for managing your project history. This…
SysAdmin,DevOps and Development
How To Rename a Local and Remote Git Branch
January 6, 2020
Git is a version control system that helps you control the stages of software development. It uses named…
SysAdmin,DevOps and Development
How to Create a New Branch in Git
December 30, 2019
This article outlines the basic commands needed to create a Git branch. A Git branch allows you to work on…
Author
Vladimir Kaplarevic
Vladimir is a resident Tech Writer at phoenixNAP. He has more than 7 years of experience in implementing e-commerce and online payment solutions with various global IT services providers. His articles aim to instill a passion for innovative technologies in others by providing practical advice and using an engaging writing style.