# git checkout

> 切换不同的分支或者索引树与工作目录文件

## commit模式

> **注意** commit模式下git checkout，因为只切换HEAD位置，不会影响索引区与工作目录。所以请调用git status查看当前git三树状态。如果索引树或工作目录有修改，git是会终止操作。

### 查看当前分支的HEAD信息

```
git checkout [HEAD]
```

* **参数**
  * HEAD (当前HEAD指针，默认值）

```bash
M       one.js
M       work.js
Your branch is up to date with 'origin/checkTag'.
```

### 切换HEAD到某个分支上

```
git checkout <branch_name>
```

* **参数**
  * branch\_name (分支名)

操作HEAD切换到某个分支，HEAD默认是目标分支的最后一次提交快照

### 新建一个分支，切换HEAD该分支上

```
git checkout -b <branch_name> [<remote_name/branch_name>]
```

* **参数**
  * branch\_name (分支名)
  * remote\_name/branch\_name (创建跟踪分支)

> 如果想拉取一个，在本地分支没有跟踪分支的远程分支，可以先执行git fetch然后再 git checkout -b &#x20;

```bash
$ git checkout -b iss53
Switched to a new branch 'iss53'
```

这相当于执行下面这两条命令：

```bash
$ git branch iss53
$ git checkout iss53
```

### 切换HEAD到某个提交快照上

```
git checkout (<tree-ish>|<tag_name>)
```

* **参数**
  * HEAD (HEAD指针，默认值）
  * tree-ish (提交索引哈希）
  * tag\_name (标签版本）

切换HEAD到某个提交快照

**注意** 1. 如果该目标的提交快照不是其所属的分支中最后一次提交，HEAD的状态是detached HEAD，git会建议你使用git checkout -b 在这个快照上新建一个分支。

## file模式

> **注意** file模式下git checkout，不会更改HEAD，但是会修改目标文件的索引树与工作目录，保持它们与HEAD一致

### 切换某个文件到某个分支/提交快照上

```
git checkout (<branch_name>|HEAD|<tree-ish>|<tag_name>) [--] <file_path>
```

* **参数**
  * branch\_name (分支名)
  * HEAD (HEAD指针，默认值）
  * tree-ish (提交索引哈希）
  * tag\_name (标签版本）
  * file\_path (文件路径）

还原git三树，与HEAD保持一致，返回到初次提交的状态，**文件上原有修改会被丢弃**

**注意** 前提是目标分支/提交快照是存在目标文件，否则git会拒绝执行

### 强制撤销修改

```
git checkout [--] <file_path>
```

* **参数**
  * file\_path (文件路径）

更改索引树与工作目录，强制回滚到最近一次提交的状态，**文件上原有修改会被丢弃**

git checkout . 与 git reset --hard效果大致相同，但是前者可以控制撤销某个文件夹（更改.为其它路径），后者不能。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wikinote.gitbook.io/git-learning/git-ji-ben-ming-ling/ti-jiao-che-xiao-yu-la-qu/git-checkout.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.