git restore --staged to unstage - Mini Project: Build & Apply

Using git restore --staged to Unstage Files

📖 Scenario: You are working on a project and accidentally added a file to the staging area using git add. You want to remove it from staging without deleting the file or losing your changes.

🎯 Goal: Learn how to use git restore --staged to unstage files that were added to the staging area by mistake.

📋 What You'll Learn

Create a new file called example.txt with some content

Add example.txt to the git staging area using git add

Use git restore --staged to unstage example.txt

Verify the file is unstaged by checking the git status

💡 Why This Matters

🌍 Real World

When working on code, sometimes you add files to the staging area by mistake. Knowing how to unstage files quickly helps you keep your commits clean and organized.

💼 Career

Developers and DevOps engineers often need to manage staged changes carefully. Mastering <code>git restore --staged</code> is essential for efficient version control and collaboration.

1

Create a new file called example.txt

Create a new file named example.txt and add the text Hello, Git! inside it.

Git

# Create a file named example.txt with the text 'Hello, Git!'
# Your code here

Hint

You can use the echo command to write text to a file.

2

Add example.txt to the git staging area

Add the file example.txt to the git staging area using the command git add example.txt.

Git

echo "Hello, Git!" > example.txt
# Add example.txt to the git staging area
# Your code here

Hint

Use git add followed by the filename to stage a file.

3

Unstage example.txt using git restore --staged

Use the command git restore --staged example.txt to remove example.txt from the staging area without deleting the file or its changes.

Git

echo "Hello, Git!" > example.txt
git add example.txt
# Unstage example.txt using git restore --staged
# Your code here

Hint

The git restore --staged command removes files from the staging area but keeps your changes in the working directory.

4

Verify example.txt is unstaged

Run git status and verify that example.txt is no longer in the staging area but is now listed as untracked or modified.

Git

echo "Hello, Git!" > example.txt
git add example.txt
git restore --staged example.txt
# Run git status to check the file status
# Your code here

Hint

The output of git status should show example.txt under "Changes not staged for commit:" or "Untracked files:" depending on the git state.

Practice

1. What does the command git restore --staged <file> do in Git?

easy

A. It commits the file to the repository.

B. It deletes the file from the working directory and staging area.

C. It removes the file from the staging area but keeps the changes in the working directory.

D. It discards all changes in the file and restores it to the last commit.

Solution

1. Step 1: Understand the staging area role

   The staging area holds files ready to be committed, but changes still exist in the working directory.

2. Step 2: Effect of git restore --staged

   This command removes the file from staging but keeps your edits in the working directory, so you can fix or adjust before committing.

3. Final Answer:

   It removes the file from the staging area but keeps the changes in the working directory. -> Option C

4. Quick Check:

   Unstage = remove from staging, keep edits [OK]

Hint: Unstage means remove from staging, keep your edits [OK]

Common Mistakes:

• Thinking it deletes the file from disk
• Confusing it with discarding changes
• Assuming it commits the file immediately

2. Which of the following is the correct syntax to unstage a file named app.js using git restore?

easy

A. git restore --staged app.js

B. git restore app.js --staged

C. git restore --unstage app.js

D. git restore --remove app.js

Solution

1. Step 1: Recall correct option order for flags

   In Git commands, flags usually come before the file names.

2. Step 2: Apply to git restore --staged

   The correct syntax places --staged before the file name: git restore --staged app.js.

3. Final Answer:

   git restore --staged app.js -> Option A

4. Quick Check:

   Flags before files = correct syntax [OK]

Hint: Put flags before filenames in git commands [OK]

Common Mistakes:

• Placing --staged after the filename
• Using non-existent flags like --unstage
• Confusing restore with reset commands

3. Given the following sequence of commands:

echo 'initial' > file.txt
 git add file.txt
 git commit -m 'initial'
 echo 'Hello' > file.txt
 git add file.txt
 git restore --staged file.txt
 git status

What will git status show about file.txt?

medium

A. file.txt is staged for commit.

B. file.txt is deleted.

C. file.txt is unmodified and not staged.

D. file.txt is modified but not staged.

Solution

1. Step 1: Analyze the commands step-by-step

   First, 'Hello' is written to file.txt. Then, git add stages it. Next, git restore --staged file.txt removes it from staging but keeps the change.

2. Step 2: Understand the status after unstaging

   Since the file is modified but unstaged, git status will show it as modified but not staged for commit.

3. Final Answer:

   file.txt is modified but not staged. -> Option D

4. Quick Check:

   Unstaged changes = modified but not staged [OK]

Hint: Unstaged files show as modified but not staged [OK]

Common Mistakes:

• Assuming file is still staged after restore --staged
• Thinking file is unmodified after unstaging
• Confusing unstaged with deleted

4. You ran git restore --staged myfile.txt but got an error: error: pathspec 'myfile.txt' did not match any files. What is the most likely cause?

medium

A. The file myfile.txt is not currently staged.

B. You misspelled the command; it should be git reset --staged.

C. The file does not exist in the working directory.

D. You need to add --force to the command.

Solution

1. Step 1: Understand the error message meaning

   The error says the file path does not match any staged files, meaning Git can't find it in the staging area.

2. Step 2: Check the file's staging status

   If the file is not staged, git restore --staged cannot unstage it, causing this error.

3. Final Answer:

   The file myfile.txt is not currently staged. -> Option A

4. Quick Check:

   Unstage error means file not staged [OK]

Hint: File must be staged to unstage it [OK]

Common Mistakes:

• Assuming command syntax is wrong
• Thinking file must exist only in working directory
• Trying to force unstage without staging first

5. You staged two files, index.html and style.css, but realize you only want to commit index.html. Which command correctly unstages style.css without losing your edits?

hard

A. git checkout -- style.css

B. git restore --staged style.css

C. git reset --hard style.css

D. git rm --cached style.css

Solution

1. Step 1: Identify the goal

   You want to unstage style.css but keep your changes in the working directory.

2. Step 2: Compare commands

   git restore --staged style.css unstages the file but keeps edits.
   git reset --hard style.css is invalid syntax with paths and cannot unstage a specific file.
   git checkout -- style.css updates working tree from index but does not unstage.
   git rm --cached style.css stages a deletion, which is not desired.

3. Final Answer:

   git restore --staged style.css -> Option B

4. Quick Check:

   Use restore --staged to unstage safely [OK]

Hint: Use git restore --staged to unstage without losing edits [OK]

Common Mistakes:

• Using git checkout which discards changes
• Using git rm --cached which removes file tracking
• Confusing git reset with discard commands