git restore --staged to unstage - Commands & Configuration

Introduction

Sometimes you add files to be saved in your next snapshot by mistake. The command git restore --staged helps you remove those files from the list of changes to save, without deleting the changes themselves.

When you accidentally added a file to the staging area but want to keep editing it before saving.

When you want to remove a file from the next commit but keep your changes in the working folder.

When you staged multiple files but decide only some should be saved now.

When you want to fix a mistake before making a commit by unstaging files.

When you want to check the difference between staged and unstaged changes.

Commands

Check which files are staged and unstaged before making changes.

Terminal

git status

Expected Output

On branch main

Changes to be committed:

  (use "git restore --staged <file>..." to unstage)



	modified:   example.txt



Changes not staged for commit:

  (use "git add <file>..." to update what will be committed)



	modified:   notes.txt

Remove example.txt from the staging area so it won't be included in the next commit, but keep your changes in the file.

Terminal

git restore --staged example.txt

Expected Output

No output (command runs silently)

→

--staged - Specifies to unstage the file from the index (staging area) without changing the working directory.

Verify that example.txt is no longer staged but still modified in your working folder.

Terminal

git status

Expected Output

On branch main

Changes not staged for commit:

  (use "git add <file>..." to update what will be committed)



	modified:   example.txt

	modified:   notes.txt

Key Concept

If you remember nothing else from this pattern, remember: git restore --staged removes files from the next commit without losing your changes.

Common Mistakes

Using git restore example.txt without --staged to unstage.

This command changes the file in your working folder to match the last commit, losing your changes.

Use git restore --staged example.txt to only unstage without changing your file.

Trying to unstage files with git reset without understanding its effect.

git reset can also unstage but may confuse beginners; git restore --staged is clearer and safer.

Use git restore --staged for unstaging files in modern Git versions.

Summary

Use git status to see which files are staged or unstaged.

Run git restore --staged filename to remove a file from the staging area without losing changes.

Check again with git status to confirm the file is unstaged but still modified.