All about checking out files or directories in git
1. How to check out one or more files or directories from another branch or commit hash into your currently-checked-out branch:
# check out all files in <paths> from branch <branch_name>
git checkout <branch_name> -- <paths>
Source: http://nicolasgallagher.com/git-checkout-specific-files-from-another-branch/.
See also man git checkout
.
Examples:
# Check out "somefile.c" from branch `my_branch`
git checkout my_branch -- somefile.c
# Check out these 4 files from `my_branch`
git checkout my_branch -- file1.h file1.cpp mydir/file2.h mydir/file2.cpp
# Check out ALL files from my_branch which are in
# directory "path/to/dir"
git checkout my_branch -- path/to/dir
If you don't specify, the branch_name
it is automatically assumed to be HEAD
, which is your most-recent commit of the currently-checked-out branch. So, you can also just do this to check out "somefile.c" and have it overwrite any local, uncommitted changes:
# Check out "somefile.c" from `HEAD`, to overwrite any local, uncommitted
# changes
git checkout -- somefile.c
# Or check out a whole folder from `HEAD`:
git checkout -- some_directory
2. Going Further: How to check out any file from any branch or commit hash into any location on your computer (VERY USEFUL!):
# General form
git show my_branch_or_commit_hash:my_file.cpp > any/path/my_file.cpp
# Example: check out `main.cpp` from 3 commits ago in your currently-checked-out
# branch (3 commits prior to `HEAD`, or `HEAD~3`) into a temporary directory
mkdir ../temp
git show HEAD~3:main.cpp > ../temp/main_old.cpp
Source where I learned this: @Jakub Narębski's answer to: git-checkout older revision of a file under a new name
3. What if you're in the middle of resolving git merge
, git cherry-pick
, git rebase
, or git revert
changes?
Well, in that case, you better do this:
# Keep `--theirs` for all conflicts within this file
git checkout --theirs -- path/to/some/file
# OR: keep `--ours` for all conflicts within this file
git checkout --ours -- path/to/some/file
OR:
# Keep `--theirs` for all conflicts within files inside this dir
git checkout --theirs -- path/to/some/dir
# OR: keep `--ours` for all conflicts within files inside this dir
git checkout --ours -- path/to/some/dir
Do NOT do the regular checkout
form in the previous section before this, unless that's what you really want to do. See the "WARNING WARNING WARNING" section in my answer here: Who is "us" and who is "them" according to Git?.
DEALING WITH path does not have our version
or path does not have their version
ERRORS:
If you ever see errors like this:
error: path 'path/to/some/dir/file1.cpp' does not have our version
# OR
error: path 'path/to/some/dir/file1.cpp' does not have their version
...when running the commands above, then you simply need to git rm
those files first and then try the git checkout --ours
or git checkout --theirs
command again. See my answer here for a detailed explanation of these commands, including a form to automatically find and delete those errored files for you: git checkout --ours when file spec includes deleted file.
4. What if you want to reset a certain file or directory to exactly match that file or directory's state in another commit or branch?
In this case, git checkout my_branch -- some_file_or_dir
is NOT enough, because if you have files in the specified directory which exist in your currently-checked-out branch or commit but do NOT exist in my_branch
, then you'd like them to be deleted locally, but git checkout
does NOT delete any files which exist locally but not on the specified commit, rather, it only overwrites files locally with their versions from the specified commit. So, to also delete files locally which should not be there, so that what you end up with locally is an exact copy of what you have on my_branch
, you must do the following:
git reset my_branch -- path/to/some/file_or_dir
git checkout-index -fa
git clean -fd
git commit -m "hard reset path/to/some/file_or_dir to its state \
as it was at my_branch"
See my own answer here for more details on this: Why git can't do hard/soft resets by path?.
See also:
- I show some more of these examples of
git checkout
in my answer here: Who is "us" and who is "them" according to Git?.
- [my answer on "How to do a --soft or --hard git reset by path"] Why git can't do hard/soft resets by path?
- git-checkout older revision of a file under a new name
- [my answer] git checkout --ours when file spec includes deleted file
- [my answer] Using git, how do you reset the working tree (local file system state) to the state of the index ("staged" files)?
master
may diverge fromexperiment
, e.g. can contain changes merged from other branches which would be lost in file is just copied. P.S. on the other hand he does not want to merge, but as far as I knowgit merge
term is for branch only, not for specific file, so no contradiction here. – Alexei Martianov