Conjuring unicorns
cozyplanescozyplanes
Gradient background
ArticlearticleΒ Β· #108

How can I find deleted stuff in Git?

Clarice Bouwer

Software Engineering Team Lead and Director of Cloudsure

Thursday, 2 September 2021 Β· Estimated 5 minute read

I was working on an about module a few months ago. I wasn't satisfied with it so I deleted it with all its related files 😬 Now I need to recover parts of this data that I had so conveniently discarded. πŸ€¦β€β™€οΈ

I can't remember the exact location of the files on disk that I am looking for and I don't know what to look for in the history, but luckily Git offers numerous ways of playing detective πŸ•΅ so I can try to get what I want back. If I recall correctly, I was working on a page called about.js.

This article is a curation of the different ways I could find to find files that can be recovered and then actually recover them. We are going to use the example of finding the lost about page and related files that selectively need to be restored.

In this article I refer to git lg which is a Git alias that I added to my global config which will print a shortened pretty version of my git history (the log).

What is the file that must be restored?

Choose a search term which you think may appear in the commit message. Think about using context-based terms like about or action-based terms like refactor, move, delete or remove. If you regularly reference file names in your commit then you can search by the filename. We are going to use the history to get the relative path and filenames of the files we want to restore.

Copy
git lg --name-status | grep <TERM>

Below is an example of the output where I got the relative filename for the about page. πŸ‘

Copy
$ git lg --name-status | grep about
...
* 1a1305c |  Add about page (4 months ago) [Clarice Bouwer]
| A     src/Components/Headers/about.js
| A     src/images/about/people.jpg
πŸ‘‰ | M     src/pages/about.js
* 9ee2ea2 |  Create layout with global styles to prep about page (4 months ago) [Clarice Bouwer]
| A     src/pages/about.js
...

We can also page through commits that have files that have been deleted. These files are listed in the output.

Copy
git lg --diff-filter=D --summary
Copy
...
⭐ * 151ef7f |  Something destructive with my about page (4 weeks ago) [Clarice Bouwer]
|
|  delete mode 100644 src/Components/About/Contact/index.js
πŸ‘‰ |  delete mode 100644 src/pages/about.js
|  delete mode 100644 src/pages/credits.js
|  delete mode 100644 src/pages/tags.js
* 1410b48 |  Generate articles (4 months ago) [Clarice Bouwer]
|
|  delete mode 100644 build/pages-article.js
...
* 23cc5dc |  Delete old themes (4 months ago) [Clarice Bouwer]
|
|  delete mode 100644 src/Components/Themes/Dark.js
|  delete mode 100644 src/Components/Themes/Light.js
|  delete mode 100644 src/Components/Themes/index.js
...

If you are interested in more than just deleted files then you can also look into using Git whatchanged git whatchanged

Copy
...
commit 168f7c6e9f7dfc404b312fcc0436960e2d6cad1a
Author: Clarice Bouwer <cbillowes@gmail.com>
Date:   Thu Sep 2 06:48:09 2021 +0400

    Add about page with featured articles

M       articles/2016/2016-05-14-importance-of-git-history/index.md
M       articles/2016/2016-06-06-branding-your-identity/index.md
M       articles/2016/2016-11-13-the-imposter-within/index.md
M       articles/2019/2019-01-15-crafting-changes-in-git/index.md
M       articles/2019/2019-01-29-working-with-git-remotes/index.md
M       articles/2019/2019-09-02-git-aliases/index.md
M       articles/2020/2020-05-03-gatsby-source-plugin.md
A       src/images/avatar.png
A       src/pages/about.js
M       tailwind.config.js
...

In what commit was this file deleted?

Use git rev-list to list all commit objects for the specified file in reverse chronological order.

Copy
git rev-list HEAD -- src/pages/about.js
Copy
$ git rev-list HEAD -- src/pages/about.js
168f7c6e9f7dfc404b312fcc0436960e2d6cad1a
e02cb810ed12448f390d2974a4986d72269d9ac4
1b5936ef601352698978176ee059dd3a6fe54fee
...

This is crappy so we are going to take these results and use them as arguments in the git show command to show all actual commits instead of just the objects.

Copy
git rev-list HEAD -- src/pages/about.js | xargs git show $1 --name-status
Copy
$ git rev-list HEAD -- src/images/about/people.jpg | xargs git show $1 --name-status
⭐ commit faed0b3ef95d23a2f465eeedb5be8da0ece19075
Author: Clarice Bouwer <cbillowes@gmail.com>
Date:   Tue May 4 20:24:05 2021 +0400

    Theme switcher on about page

M       package-lock.json
M       package.json
M       src/Components/Layout/index.js
M       src/Components/ThemeSwitcher/index.js
D       src/images/about/coffee-begin.jpg
D       src/images/about/legos.jpg
D       src/images/about/people.jpg
D       src/images/about/screen-with-code.jpg
πŸ‘‰ D       src/pages/about.js

commit 1a1305c5f5774a1203f2f11f3a7b3c7513887dc6
Author: Clarice Bouwer <cbillowes@gmail.com>
Date:   Tue May 4 07:57:39 2021 +0400

    Add about page

M       gatsby-config.js
M       package-lock.json
M       package.json
M       src/Components/GlobalStyles/index.js
A       src/Components/Headers/about.js
M       src/Components/Layout/index.js
M       src/Components/Menu/index.js
M       src/Components/Navigation/index.js
A       src/images/about/people.jpg
M       src/pages/about.js

How can I restore this file?

πŸ’• Git Tower has a brilliant guide titled Restoring deleted files in Git. In this guide they cover different scenarios in depth. I am going to summarize some of those commands here.

  1. Deleted a file that was not committed. Works if file was staged or not.

    Copy
    git checkout HEAD <filename>
  2. Deleted and committed the file. --soft so that you don't lose all your current changes.

    Copy
    git reset --soft HEAD~1
  3. Deleted and then made more commits. Decide how far back you want to go to restore this file. Each one will be an incremented number starting from 1. ~ indicates that you are going back in time. Use the commit hash where the file was deleted and add this number to the end. faed0b3ef95d23a2f465eeedb5be8da0ece19075~1 Alternatively end the hash with a caret ^ to go to its previous commit.

    Copy
    # go back in time
    git checkout <deletion commit hash>~1 -- <filename>
    
    # another way to retrieve the file using the previous commit
    git checkout <deletion commit hash>^ <filename>
  4. Deleted and then pushed that commit.

    Copy
    # --no-commit
    # option prevents the command from creating a new commit right away,
    # instead allowing you to choose exactly which of the changes introduced in the old
    # commit you want to revert in your new commit.
    git revert --no-commit <commit>

And that's it! πŸŽ‰ Let me know if you have better techniques or alternative approaches. It would be great to add them here!

References

Stack Overflow

Share this article on…


Subscribe to my newsletter

Get notified monthly about any new articles, tutorials, and courses. I promise to keep the emails short and sweet, and never spam you.

By signing up you acknowledge the Privacy Policy. Please keep an eye out in your junk/spam folder for the confirmation email.