What's the difference between `git add .` and `git add -u`?
Asked Answered
L

3

77

I was assuming that both work in the same way. Both add every file onto index. But I seem wrong.

  • What's the difference between git add . and git add -u?
Lophophore answered 3/2, 2010 at 7:50 Comment(0)
E
80

It is one of the git gotchas mentioned here (pre Git 2.0).

git add . only adds what is there, not what has been deleted (if tracked).

git add .
git commit
git status
//hey! why didn't it commit my deletes?, Oh yeah, silly me
git add -u .
git commit --amend

git add -A would take care of both steps...


With Git 2.0, git add -A is default.

git add <path> is the same as "git add -A <path>" now, so that "git add dir/" will notice paths you removed from the directory and record the removal.
In older versions of Git, "git add <path>" used to ignore removals.

You can say "git add --ignore-removal <path>" to add only added or modified paths in <path>, if you really want to.


Warning (git1.8.3 April 2013, for upcoming git2.0).
I have modified my answer to say git add -u ., instead of git add -u.:

git add -u will operate on the entire tree in Git 2.0 for consistency with "git commit -a" and other commands.
Because there will be no mechanism to make "git add -u" behave as "git add -u .", it is important for those who are used to "git add -u" (without pathspec) updating the index only for paths in the current subdirectory to start training their fingers to explicitly say "git add -u ." when they mean it before Git 2.0 comes.

As I mentioned in "e"

Eada answered 3/2, 2010 at 7:56 Comment(6)
Thanks for your answer and an example. The "hey!" line really helps me.Lophophore
@TK: yes, Benjol (stackoverflow.com/users/11410/benjol)'s example is a good one.Eada
It seems we don't need to put the .(pathspec) with Git 2.x. It works find when I tested.Stephen
Also, from Git 2.0, git add . adds all changes to index as -A option is default. Check this answer https://mcmap.net/q/11929/-difference-between-quot-git-add-a-quot-and-quot-git-add-quotStephen
@Sangdol Thank you for this reminder. I have updated the answer accordingly.Eada
Very helpful thanks. Unfortunately this is bad design. The property -u should have become the update command all by its own. Laziness? Mountain of technical debt?Fur
T
26

Like the manual says: git add . will add all files in the current directory, whereas git add -u . will only add those already being tracked.

Tenancy answered 3/2, 2010 at 7:55 Comment(4)
add -u will also stage deletions.Thermotaxis
only if the deleted file was tracked ;)Tenancy
add -u is the commit -a equivalent, sort of(in files it operates on).Sclerosed
Bannier: If the deleted file wasn't tracked then there's nothing to be deleted from the staging area anyway?Thermotaxis
B
14

git add documentaiton

git add . 

add all files from the current directory

git add -u 

only update files currently being tracked.

Bentlee answered 3/2, 2010 at 7:56 Comment(1)
Perhaps cover differences between Git 2.0 and versions of Git before that?Atrabilious

© 2022 - 2024 — McMap. All rights reserved.