To delete a Git branch, first make sure it has been merged or no retention is required. Use git branch -d to delete the local merged branch. If you need to force delete unmerged branches, use the -D parameter. Remote branch deletion uses the git push origin --delete branch-name command, and can synchronize other people's local repositories through git fetch --prune. 1. To delete the local branch, you need to confirm whether it has been merged; 2. To delete the remote branch, you need to use the --delete parameter; 3. After deletion, you should verify whether the branch is successfully removed; 4. Communicate with the team to avoid accidentally deleting shared branches; 5. Clean useless branches regularly to keep the warehouse clean.

Deleting a Git branch is straightforward, but it's important to know exactly what you're doing—especially if you're removing a branch that others might be using. Here's how to do it properly.

Delete a Local Git Branch

If you're done working on a feature or bug fix and have already merged the changes into another branch (like main or dev ), you can safely delete the local branch.

To delete a local branch, use this command:

 git branch -d branch-name

• This will only work if the branch has been fully merged.
• If you want to force delete an unmerged branch, use -D instead:

 git branch -d branch-name

Pro tip: Double-check which branch you're deleting by listing all branches with git branch .

Delete a Remote Git Branch

If you've pushed a branch to a remote repository (like GitHub or GitLab) and no longer need it, you'll need to delete it separately from your local copy.

Use this command to delete a remote branch:

 git push origin --delete branch-name

This tells Git to remove the branch from the remote repository.

Alternatively, some older setups may require this format:

 git push origin :branch-name

But the --delete flag is more readable and recommended.

Confirm the Branch Is Gone

After deletion, it's good practice to verify that the branch was removed successfully.

For local branches:

 git branch

For remote branches:

 git ls-remote --heads origin

Or simply fetch again and check:

 git fetch
git branch -r

Also, if someone else worked on that branch, they'll need to prune their local tracking branches to avoid confusion.

They can do that with:

 git fetch --prune

When to Delete a Branch

Branches are usually deleted after a feature or fix has been merged into the main codebase. Common scenarios include:

• Feature complete and merged into main or develop
• Hotfix deployed and confirmed working
• Experimental branch turned out not useful
• Cleaning up old or unused branches for better organization

Be cautious when deleting shared branches. Always communicate with your team before removing anything that might still be in use.

Git branch cleanup is part of good version control hygiene. It helps keep your repository organized and easier to navigate. Just remember to confirm merges, coordinate with teammates, and always double-check the branch name before deletion.

Basically that's it.

The above is the detailed content of How do I delete a Git branch?. For more information, please follow other related articles on the PHP Chinese website!