I have a main
branch with a file called app.js
. I made changes to this file on an experiment
branch.
I want to apply only the changes made to app.js
from experiment
onto the main
branch.
master
may diverge from experiment
, 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 know git merge
term is for branch only, not for specific file, so no contradiction here. - anyone git checkout main # first get back to main
git checkout experiment -- app.js # then copy the version of app.js
# from branch "experiment"
See also Undo working copy modifications of one file in Git.
With the new git switch
and git restore
commands, that would be:
git switch main
git restore --source experiment -- app.js
By default, only the working tree is restored.
If you want to update the index as well (meaning restore the file content, and add it to the index in one command):
git restore --source experiment --staged --worktree -- app.js
# shorter:
git restore -s experiment -SW -- app.js
As Jakub Narębski mentions in the comments:
git show experiment:path/to/app.js > path/to/app.js
works too, except that, as detailed in the SO question "How to retrieve a single file from specific revision in Git?", you need to use the full path from the root directory of the repo.
Hence the path/to/app.js used by Jakub in his example.
As Frosty mentions in the comment:
you will only get the most recent state of app.js
But, for git checkout
or git show
, you can actually reference any revision you want, as illustrated in the SO question "git checkout revision of a file in git gui":
$ git show $REVISION:$FILENAME
$ git checkout $REVISION -- $FILENAME
would be the same is $FILENAME is a full path of a versioned file.
$REVISION
can be as shown in git rev-parse
:
experiment@{yesterday}:app.js # app.js as it was yesterday
experiment^:app.js # app.js on the first commit parent
experiment@{2}:app.js # app.js two commits ago
and so on.
schmijos adds in the comments:
you also can do this from a stash:
git checkout stash -- app.js
This is very useful if you're working on two branches and don't want to commit.
Answered 2023-09-21 08:07:00
experiment:./app.js
. (You don't have to specify the full path.) I learned this thanks to the very helpful error message git gave me: "Did you mean 'mybranch:full/path/to/my/file.xsl' aka 'mybranch:./file.xsl'?" Yes, I did! I don't think I've ever been so delighted by a fatal error message. - anyone --
, I've done the same without it. Am I missing something ? - anyone Everything is much simpler. Use git checkout for that.
Suppose you're on the master branch. To get app.js from the new-feature branch, do:
git checkout new-feature path/to/app.js
// Note that there isn't any leading slash in the path!
This will bring you the contents of the desired file. You can, as always, use part of the SHA-1 hash value instead of the new-feature branch name to get the file as it was in that particular commit.
Note: new-feature needs to be a local branch, not a remote one.
Answered 2023-09-21 08:07:00
git checkout origin/source_branch path/to/file
because if you have neglected to update the source branch of your local repo, you might get an old version of the file...Ask me how I know. ;) - anyone git checkout branch_name file_name
Example:
git checkout master App.java
This will not work if your branch name has a period in it.
git checkout "fix.june" alive.html
error: pathspec 'fix.june' did not match any file(s) known to git.
Answered 2023-09-21 08:07:00
git
# 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"
# - WARNING!: If you have uncommitted changes in this dir, they will be
# permanently lost when you run this command! See my lamentations in my
# comment here:
# https://stackoverflow.com/questions/2689265/git-how-to-undo-a-checkout-of-unstaged-files-which-discards-local-changes/2689318?noredirect=1#comment135379081_2689318
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
If you have some staged deletions of the file you are trying to check out (via a previous rm somefile.c && git add somefile.c
), however, then you may see this error from git
:
$ git checkout -- somefile.c error: pathspec 'somefile.c' did not match any file(s) known to git
In that case, you have to be explicit and specify a branch or commit, such as HEAD
:
# Check out "somefile.c" from `HEAD`, to overwrite any local, uncommitted
# changes
git checkout HEAD -- somefile.c
# Or check out a whole folder from `HEAD`:
git checkout HEAD -- some_directory
# 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
git merge
, git cherry-pick
, git rebase
, or git revert
changes?Well, in that case, you better do the following. Note: to know which commit hash or branch --theirs
and --ours
are in each context, see my answer here: Who is "us" and who is "them" according to Git?:
# 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 referenced above: 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.
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 commit or branch my_branch
, you must do the following:
# How to "hard reset" "path/to/some/file_or_dir" to its state exactly as it was
# at commit or branch `my_branch`
#
# WARNING: `git status` should be TOTALLY CLEAN before beginning this process!
# Otherwise, you risk PERMANENTLY LOSING any uncommitted changes shown by
# `git status`, since `git clean -fd` 'f'orce deletes ALL files
# and 'd'irectories which are in your current working tree (file system), but
# which are *not* in the path you specify below in commit or branch `my_branch`.
# Therefore, anything NOT already committed gets **permanently lost** as though
# you had used `rm` on it!
git reset my_branch -- path/to/some/file_or_dir
git checkout-index -fa
git clean -fd # SEE WARNING ABOVE!
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?
git checkout
in my answer here: Who is "us" and who is "them" according to Git?.Answered 2023-09-21 08:07:00
git clean -fd
without first understanding what it will do. Mercifully Jetbrains kept backups of these files for me. Think, \rm -rf *
... - anyone Supplemental to VonC's and chhh's answers:
git show experiment:path/to/relative/app.js > app.js
# If your current working directory is relative, then just use:
git show experiment:app.js > app.js
or
git checkout experiment -- app.js
Answered 2023-09-21 08:07:00
--
) between the branch name and paths optional? Is it only to prevent paths, which would start with a dash, from being treated as options / switches? - anyone --
is optional, but it's more useful to avoid conflict with branch names. For example, git checkout -- foo
means "check out file foo from HEAD" (ie. overwrite local changes in foo, ie. a subset of git reset --hard
), but git checkout foo
could mean that or "let's go to branch foo". - anyone To restore a file from another branch, simply use the following command from your working branch:
git restore -s my-other-branch -- ./path/to/file
The -s
flag is short for source
i.e. the branch from where you want to pull the file.
(The chosen answer is very informative but also a bit overwhelming.)
Answered 2023-09-21 08:07:00
Or if you want all the files from another branch:
git checkout <branch name> -- .
Answered 2023-09-21 08:07:00
.
makes a huge difference: instead of moving to another branch it copies all files from there while still leaving you on the current one. You get contents from other branch without going into it. - anyone If you want the file from a particular commit (any branch), say 06f8251f
git checkout 06f8251f path_to_file
For example, on Windows:
git checkout 06f8251f C:\A\B\C\D\file.h
Answered 2023-09-21 08:07:00
git checkout <branch_name> -- <paths>
Answered 2023-09-21 08:07:00
This is a pragmatic approach which doesn't directly answer the original post, but some have found useful:
If the branch in question is on GitHub, then you can navigate to the desired branch and file using any of the many tools that GitHub offers, then click 'Raw' to view the plain text, and (optionally) copy and paste the text as desired.
I like this approach because it lets you look at the remote file in its entirety before pulling it to your local machine.
Answered 2023-09-21 08:07:00
There is also a simple solution for all who like to avoid unknown Git commands or are afraid to wreck something:
It probably takes longer than the appropriate Git command... but it works and is easy to understand.
Answered 2023-09-21 08:07:00
Another way is to create a patch with the differences and apply it in the master branch. For instance, let's say the last commit hash value before you started working on app.js is 00000aaaaa and the commit hash value containing the version you want is 00000bbbbb.
Then you run this on the experiment branch:
git diff 00000aaaaa 00000bbbbb app.js > ~/app_changes.git
This will create a file with all the differences between those two commits for app.js that you can apply wherever you want. You can keep that file anywhere outside the project.
Then, in master you just run:
git apply ~/app_changes.git
Now you are going to see the changes in the projects as if you had made them manually.
Answered 2023-09-21 08:07:00
To checkout a file from another branch is a simple one line command:
git checkout branch C:\path\to\file.cs
If you'd like multiple files
git checkout branch C:\path\to\file1.cs C:\path\to\file2.cs
Answered 2023-09-21 08:07:00
Make sure you are on the branch where you want to place the file. You can switch to the desired branch using git checkout <branch_name> if you're not already on it.
git checkout <branch_name>
Use git checkout to retrieve the file from another branch. Replace <branch_name> with the name of the branch you want to get the file from and <path_to_file> with the path to the file within that branch.
git checkout <branch_name> -- <path_to_file>
Answered 2023-09-21 08:07:00
git switch
and git restore
that I mentioned in my answer? They are clearer than using the same command (checkout
) both for branch operation and file operation. - anyone Use:
git checkout master - Go to the master branch first
git checkout <your-branch> -- <your-file> -- Copy your file data from your branch.
git show <your-branch>:path/to/<your-file>
Answered 2023-09-21 08:07:00