If I run git diff I would expect to see a list of changes of my working directory relative to whatever had been committed before (or a list of the working directory contents if it’s a new repository with no commits). Try this example:
$ mkdir temp
$ cd temp
$ git init
$ echo "first line" > test.txt
$ git status
# On branch master
# Untracked files:
# (use "git add <file>..." to include in what will be committed)
#
# test.txt
nothing added to commit but untracked files present (use "git add" to track)
Let’s see a diff of test.txt:
$ git diff
This doesn’t give any output!
I would expect to see a diff like + first line, but instead I get nothing. It doesn’t tell me what’s going on. People on Stack Overflow tell me to git add some files so I do:
$ git add .
$ git diff
Still nothing!
Git GUI shows the changes.
git status -v shows the changes.
But for some reason git diff doesn’t show anything.
So my questions are:
- How, in plain English, does
git diffwork? - How can I show a diff of all the changes I’ve made (unstaged and staged)?
Some people at my company are using Git, but the SVN crowd are going to point at this as a case of where Git is too confusing to be usable.
Why do you get no
git diffoutput before adding?Git does not treat files in the filesystem as automatically included in the version control system. You have to add things explicitly into the Git repository (as you are doing by adding the current directory with
git add .).There is no output to
git diffbecause Git doesn’t see any changes inside your repository, only files outside the repository, which it considers ‘untracked’ and so ignores when generating a diff.I found this one of the key differences to version control systems like SVN (along with staging and ignoring directories).
If you want the untracked files to be included,
git addthem.If you don’t want them in your repository, add them to your
.gitignore(seegit ignore --help). This is good for C object files or Python.pycfiles.Why don’t I get
git diffoutput after adding?!So this is slightly different. If you do
git statusyou will see the file is now in the staging area. This is the area for files that you are about to commit.When you
git adda new file into the Git repository, it skips the working copy and goes straight into the staging area. This make sense in a way, andgit addalways moves files into staging area whether it is tracked or untracked.To see the differences between the last check in and the staging area do
git diff --cached.To see the differences between the staging area and your working copy, do
git diff. If there is nothing in the staging area then this is the same as doing a diff between the last check in and your working copy.