tldr/pages/common/git-checkout.md

# git checkout

> Checkout a branch or paths to the working tree.
> Homepage: <https://git-scm.com/docs/git-checkout>.

- Create and switch to a new branch:

`git checkout -b {{branch_name}}`

- Create and switch to a new branch based on a specific reference (branch, remote/branch, tag are examples of valid references):

`git checkout -b {{branch_name}} {{reference}}`

- Switch to an existing local branch:

`git checkout {{branch_name}}`

- Switch to an existing remote branch:

`git checkout --track {{remote_name}}/{{branch_name}}`

- Discard all unstaged changes in the current directory (see `git reset` for more undo-like commands):

`git checkout .`

- Discard unstaged changes to a given file:

`git checkout {{file_name}}`

- Replace a file in the current directory with the version of it committed in a given branch:

`git checkout {{branch_name}} -- {{file_name}}`
Fix lint for common 2015-10-22 08:31:52 +01:00			`# git checkout`
split git commands 2014-03-09 12:20:13 +00:00
Formatted all pages according to guidelines. 2016-01-07 17:31:27 +00:00			`> Checkout a branch or paths to the working tree.`
multiple pages: add homepages (#2660) 2019-01-30 11:19:23 +00:00			`> Homepage: <https://git-scm.com/docs/git-checkout>.`
split git commands 2014-03-09 12:20:13 +00:00
Formatted all pages according to guidelines. 2016-01-07 17:31:27 +00:00			`- Create and switch to a new branch:`
split git commands 2014-03-09 12:20:13 +00:00
fixup: token string style (#1081) - use underscore rather than minus - use lower case rather than uppder case 2016-09-21 16:35:46 +01:00			`git checkout -b {{branch_name}}`
Undo unstaged local modification 2015-11-23 23:21:20 +00:00
git checkout: add example for creating new branch based on remote branch with different name (#2494) 2018-10-28 00:52:23 +01:00			`- Create and switch to a new branch based on a specific reference (branch, remote/branch, tag are examples of valid references):`

			`git checkout -b {{branch_name}} {{reference}}`

git-checkout: correct checkout of remote branch (#1359) As described in http://stackoverflow.com/a/9537923 (paraphrased below): > You need to create a local branch that tracks a remote branch. > The following command will create a local branch > tracking the remote branch of the same name. > When you push your changes the remote branch will be updated. > > `git checkout --track [remotename]/[branch]` > > This is a shorthand for `git checkout -b [branch] [remotename]/[branch]`. > > For git 1.7.2.3 and higher this is enough: `git checkout daves_branch` > > Note that with recent git versions, > this will command not create a local branch and will put you in a 'detached HEAD' state. > If you want a local branch, use the --track option. > Full details here: http://git-scm.com/book/en/v2/Git-Branching-Remote-Branches#Tracking-Branches 2017-04-30 11:17:03 +01:00			`- Switch to an existing local branch:`
Add git-checkout example for files across branches 2016-08-23 20:33:31 +01:00
			`git checkout {{branch_name}}`

git-checkout: correct checkout of remote branch (#1359) As described in http://stackoverflow.com/a/9537923 (paraphrased below): > You need to create a local branch that tracks a remote branch. > The following command will create a local branch > tracking the remote branch of the same name. > When you push your changes the remote branch will be updated. > > `git checkout --track [remotename]/[branch]` > > This is a shorthand for `git checkout -b [branch] [remotename]/[branch]`. > > For git 1.7.2.3 and higher this is enough: `git checkout daves_branch` > > Note that with recent git versions, > this will command not create a local branch and will put you in a 'detached HEAD' state. > If you want a local branch, use the --track option. > Full details here: http://git-scm.com/book/en/v2/Git-Branching-Remote-Branches#Tracking-Branches 2017-04-30 11:17:03 +01:00			`- Switch to an existing remote branch:`

			`git checkout --track {{remote_name}}/{{branch_name}}`

Refactor: change "folder" to "directory" where needed. This commit fixes every instance in which the word "folder" is incorrectly used instead of "directory". 2019-02-11 18:00:49 +00:00			- Discard all unstaged changes in the current directory (see `git reset` for more undo-like commands):
Undo unstaged local modification 2015-11-23 23:21:20 +00:00
Fixed annoyingly incorrect file syntaxes 2016-01-07 15:51:03 +00:00			`git checkout .`
Add git-checkout example for files across branches 2016-08-23 20:33:31 +01:00
git-checkout: "modifications" --> "changes" 2017-05-15 17:54:24 +01:00			`- Discard unstaged changes to a given file:`
git-checkout: mention reset, add single-file ex. 2017-05-15 17:52:38 +01:00
			`git checkout {{file_name}}`

Refactor: change "folder" to "directory" where needed. This commit fixes every instance in which the word "folder" is incorrectly used instead of "directory". 2019-02-11 18:00:49 +00:00			`- Replace a file in the current directory with the version of it committed in a given branch:`
Add git-checkout example for files across branches 2016-08-23 20:33:31 +01:00
			`git checkout {{branch_name}} -- {{file_name}}`