Create
cancel
Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Next challenges

Recent achievements

  • Global
  • Personal

Recognition

  • Give kudos
  • Received
  • Given

Leaderboard

  • Global

Trophy case

Kudos (beta program)

Kudos logo

You've been invited into the Kudos (beta program) private group. Chat with others in the program, or give feedback to Atlassian.

View group

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Staged vs Unstaged

What are the differences between files in Staged and Unstaged and what does it mean?

5 answers

1 accepted

The staging area (aka index) is a container where git collects all changes which will be part of the next commit.

If you are editing a versioned file on your local machine, git recognizes that your file is modified - but it will not be automatically part of your next commit and is therfore unstaged. Staging the file will put the file into the staging area (index). The next git commit will transfer all items from staging area into your repository.

What is this good for? Imagine you are in hectic and you have to fix a few bugs in your software. Usually you edit your files and fix simultaneously several bugs. After this you have a lot of unstaged but modified files. On the other hand you want to have "clean" commits: each commit should be definitively related to a single bug only. Using the staging area you could collect all changes referring to a single bug and make a clean commit - in your next step you stage all changes for the next bug and make the next clean commit ...

You could not only stage complete files - but also "hunks" (parts of a file) and even single lines from a modified file (sourcetree is a great tool for preparing the staging area with great facilities for staging files, hunks or lines).

Resumee: Editing a versioned file makes the file modified, but unstaged. Staging the file/hunk/line adds the change to the staging area. The changes within the staging area are part of the next commit. The commit transfers all changes from staging area into your repository. The staging area allows you to collect all changes to get a "clean" commit.

Hope this was clear

 

See:

Hi,

 

This is very clean and helpful comments.

Thanks a lot.

 

Like # people like this

Very "clean" explanation. :)

Thanks.

Like vasyl.lukachynets likes this

Very good explanation :)

Thanks !! 

Good answer, but you wrote "defintifly".. I think you mean definitively.. Just saying.. please delete this after you fix =D

Voila ... after you staged this orthographical proposal, I commited this to my original post :-)

As I'm not a native english speaker, thanks for your hint!

Like mariolina likes this

Answer still working :-) after quite many years.

Okay, but what about added/deleted files? Now I'm often facing new added files are going right into staged, that is not expected for me. Also, if I unstage them they are getting lost away from index complitely.

This helped! Thank you so much for the explanation and links!

Glad I could help you. You might mark my answer as accepted as well ....

Lai bhari ! 

Great explanation ! Thanks a los :)

Thanks!!!  =)

Great explanation. Very clear and easy to understand. Thanks.

Suggest an answer

Log in or Sign up to answer
TAGS
Community showcase
Posted in Sourcetree

[dev team] Sourcetree for Windows 2019 Preview - Dark Theme

Hi folks, While the full post is over on our blog I'd like to share the dark theme we've got planned for 2019 here directly as well to keep the discussion going.  The ...

3,195 views 19 18
Join discussion

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you