133 lines
4.7 KiB
Markdown
133 lines
4.7 KiB
Markdown
---
|
||
title: Git Branch
|
||
localeTitle: Git Branch
|
||
---
|
||
## Git Branch
|
||
|
||
Git的分支功能允许您创建项目的新分支，以测试想法，隔离新功能或实验，而不会影响主项目。
|
||
|
||
**目录**
|
||
|
||
* [查看分支机构](#view-branches)
|
||
* [结账分行](#checkout-a-branch)
|
||
* [创建一个新分支](#create-a-new-branch)
|
||
* [重命名分支](#rename-a-branch)
|
||
* [删除分支](#delete-a-branch)
|
||
* [比较分支](#compare-branches)
|
||
* [帮助Git Branch](#help-with-git-branch)
|
||
* [更多信息](#more-information)
|
||
|
||
### 查看分支机构
|
||
|
||
要查看Git存储库中的分支，请运行以下命令：
|
||
|
||
```shell
|
||
git branch
|
||
```
|
||
|
||
要查看远程跟踪分支和本地分支，请运行以下命令：
|
||
|
||
```shell
|
||
git branch -a
|
||
```
|
||
|
||
您当前所在的分支旁边会有一个星号（\*）。
|
||
|
||
您可以使用`git branch`包含许多不同的选项来查看不同的信息。有关分支的更多详细信息，可以使用`-v` （或`-vv`或`--verbose` ）选项。分支列表将包括其名称旁边的每个分支的`HEAD`的SHA-1值和提交主题行。
|
||
|
||
您可以使用`-a` （或`--all` ）选项显示本地分支以及存储库的任何远程分支。如果您只想查看远程分支，请使用`-r` （或`--remotes` ）选项。
|
||
|
||
### 结账分行
|
||
|
||
要签出现有分支，请运行以下命令：
|
||
|
||
```shell
|
||
git checkout BRANCH-NAME
|
||
```
|
||
|
||
通常，除非您的工作目录是干净的，否则Git不会让您签出另一个分支，因为您将丢失任何未提交的工作目录更改。您有三种方法可以处理更改： 1）垃圾（详见[Git checkout](https://guide.freecodecamp.org/git/git-checkout/) ）或 2）提交它们（ [有关详细信息，](https://guide.freecodecamp.org/git/git-commit/)请参阅[Git提交](https://guide.freecodecamp.org/git/git-commit/) ）或 3）存储它们（ [有关详细信息，](https://guide.freecodecamp.org/git/git-stash/)请参阅[Git存储](https://guide.freecodecamp.org/git/git-stash/) ）。
|
||
|
||
### 创建一个新分支
|
||
|
||
要创建新分支，请运行以下命令：
|
||
|
||
```shell
|
||
git branch NEW-BRANCH-NAME
|
||
```
|
||
|
||
请注意，此命令仅创建新分支。你需要运行`git checkout NEW-BRANCH-NAME`切换到它。
|
||
|
||
有一个快捷方式可以立即创建和签出新分支。您可以使用`git checkout`传递`-b`选项（用于分支）。以下命令执行相同的操作：
|
||
|
||
```shell
|
||
# Two-step method
|
||
git branch NEW-BRANCH-NAME
|
||
git checkout NEW-BRANCH-NAME
|
||
|
||
# Shortcut
|
||
git checkout -b NEW-BRANCH-NAME
|
||
```
|
||
|
||
创建新分支时，它将包括来自父分支的所有提交。父分支是您在创建新分支时所在的分支。
|
||
|
||
### 重命名分支
|
||
|
||
要重命名分支，请运行以下命令：
|
||
|
||
```shell
|
||
git branch -m OLD-BRANCH-NAME NEW-BRANCH-NAME
|
||
|
||
# Alternative
|
||
git branch --move OLD-BRANCH-NAME NEW-BRANCH-NAME
|
||
```
|
||
|
||
### 删除分支
|
||
|
||
Git不会让你删除你当前所在的分支。首先需要签出一个不同的分支，然后运行命令：
|
||
|
||
```shell
|
||
git branch -d BRANCH-TO-DELETE
|
||
|
||
# Alternative:
|
||
git branch --delete BRANCH-TO-DELETE
|
||
```
|
||
|
||
您切换到的分支会产生影响。如果您尝试删除的分支中的更改未完全合并到当前分支中，Git将抛出错误。你可以覆盖它并强制Git删除带有`-D`选项的分支（注意大写字母）或使用`--force`选项和`-d`或`--delete` ：
|
||
|
||
```shell
|
||
git branch -D BRANCH-TO-DELETE
|
||
|
||
# Alternatives
|
||
git branch -d --force BRANCH-TO-DELETE
|
||
git branch --delete --force BRANCH-TO-DELETE
|
||
```
|
||
|
||
### 比较分支
|
||
|
||
您可以使用`git diff`命令比较分支：
|
||
|
||
```shell
|
||
git diff FIRST-BRANCH..SECOND-BRANCH
|
||
```
|
||
|
||
你会看到分支之间变化的彩色输出。对于所有已更改的行， `SECOND-BRANCH`版本将是以“+”开头的绿线， `FIRST-BRANCH`版本将是以“ - ”开头的红线。如果您不希望Git为每次更改显示两行，则可以使用`--color-words`选项。相反，Git将以红色显示一行删除的文本，并以绿色添加文本。
|
||
|
||
如果要查看完全合并到当前分支的所有分支的列表（换句话说，当前分支包括列出的其他分支的所有更改），请运行命令`git branch --merged` 。
|
||
|
||
### 帮助Git Branch
|
||
|
||
如果您忘记了如何使用选项，或想要探索`git branch`命令的其他功能，您可以运行以下任何命令：
|
||
|
||
```shell
|
||
git help branch
|
||
git branch --help
|
||
man git-branch
|
||
```
|
||
|
||
### 更多信息：
|
||
|
||
* `git merge`命令： [fCC指南](https://guide.freecodecamp.org/git/git-merge/)
|
||
* `git checkout`命令： [fCC指南](https://guide.freecodecamp.org/git/git-checkout/)
|
||
* `git commit`命令： [fCC指南](https://guide.freecodecamp.org/git/git-commit/)
|
||
* `git stash`命令： [fCC指南](https://guide.freecodecamp.org/git/git-stash/)
|
||
* Git文档： [分支](https://git-scm.com/docs/git-branch) |