When working in Git, or other version control systems, the concept of "saving" is a more nuanced process than saving in a word processor or other traditional file editing applications. The traditional software expression of "saving" is synonymous with the Git term "committing". A commit is the Git equivalent of a "save". Traditional saving should be thought of as a file system operation that is used to overwrite an existing file or write a new file. Alternatively, Git committing is an operation that acts upon a collection of files and directories.

Saving changes in Git vs SVN is also a different process. SVN Commits or 'check-ins' are operations that make a remote push to a centralized server. This means an SVN commit needs Internet access in order to fully 'save' project changes. Git commits can be captured and built up locally, then pushed to a remote server as needed using the git push -u origin master command. The difference between the two methods is a fundamental difference between architecture designs. Git is a distributed application model whereas SVN is a centralized model. Distributed applications are generally more robust as they do not have a single point of failure like a centralized server.

The commands: git add, git status, and git commit are all used in combination to save a snapshot of a Git project's current state.

Git has an additional saving mechanism called 'the stash'. The stash is an ephemeral storage area for changes that are not ready to be committed. The stash operates on the working directory, the first of the three trees and has extensive usage options. To learn more visit the git stash page.

A Git repository can be configured to ignore specific files or directories. This will prevent Git from saving changes to any ignored content. Git has multiple methods of configuration that manage the ignore list. Git ignore configure is discussed in further detail on the git ignore page.

git add

The git add command adds a change in the working directory to the staging area. It tells Git that you want to include updates to a particular file in the next commit. However, git add doesn't really affect the repository in any significant way—changes are not actually recorded until you run git commit.

In conjunction with these commands, you'll also need git status to view the state of the working directory and the staging area.

Wie es funktioniert

The git add and git commit commands compose the fundamental Git workflow. These are the two commands that every Git user needs to understand, regardless of their team’s collaboration model. They are the means to record versions of a project into the repository’s history.

Developing a project revolves around the basic edit/stage/commit pattern. First, you edit your files in the working directory. When you’re ready to save a copy of the current state of the project, you stage changes with git add. After you’re happy with the staged snapshot, you commit it to the project history with git commit. The git reset command is used to undo a commit or staged snapshot.

In addition to git add and git commit, a third command git push is essential for a complete collaborative Git workflow. git push is utilized to send the committed changes to remote repositories for collaboration. This enables other team members to access a set of saved changes.

Git-Tutorial: git add und Snapshots

The git add command should not be confused with svn add, which adds a file to the repository. Instead, git add works on the more abstract level of changes. This means that git add needs to be called every time you alter a file, whereas svn add only needs to be called once for each file. It may sound redundant, but this workflow makes it much easier to keep a project organized.

The staging area

The primary function of the git add command, is to promote pending changes in the working directory, to the git staging area. The staging area is one of Git's more unique features, and it can take some time to wrap your head around it if you’re coming from an SVN (or even a Mercurial) background. It helps to think of it as a buffer between the working directory and the project history. The staging area is considered one of the "three trees" of Git, along with, the working directory, and the commit history.

Statt alle Änderungen zu bestätigen, die du seit dem letzten Commit gemacht hast, ermöglicht es dir der Staging-Bereich, zusammengehörige Änderungen in stark fokussierten Snapshots zu gruppieren, bevor du sie für den Projektverlauf bestätigst. Das heißt, dass du alle möglichen Änderungen an nicht zusammengehörigen Dateien vornehmen, dann zurückgehen und sie in logische Commits unterteilen kannst, indem du zusammengehörige Änderungen dem Staging-Bereich hinzufügst und diese nacheinander bestätigst. Wie in jedem Revisionskontrollsystem ist es wichtig, auch kleinste Commits zu erstellen, damit bei minimalen Auswirkungen auf andere Teile des Projekts Bugs nachvollzogen und Änderungen rückgängig gemacht werden können.

Allgemeine Optionen

git add <file>

Mit diesem Befehl überführst du alle Änderungen in <file> in die Staging-Umgebung, damit sie in den nächsten Commit aufgenommen werden können.

git add <directory>

Mit diesem Befehl überführst du alle Änderungen in <directory> in die Staging-Umgebung, damit sie in den nächsten Commit aufgenommen werden können.

git add -p

Mit diesem Befehl startest du eine interaktive Staging-Sitzung, in der du auswählen kannst, welche Abschnitte einer Datei in den nächsten Commit aufgenommen werden sollen. Dir wird ein Block von Änderungen angezeigt und du wirst zur Eingabe eines Befehls aufgefordert. Mit y verschiebst du den Block in die Staging-Umgebung, mit n ignorierst du den Block. Mit der Option s teilst du den Block in kleinere Blöcke auf, mit e kannst du ihn manuell bearbeiten und mit q brichst du den Vorgang ab.


Wenn du ein neues Projekt beginnst, hat git add dieselbe Funktion wie svn import. Mithilfe der folgenden beiden Befehle kannst du einen ersten Commit des aktuellen Verzeichnisses erstellen:

git add .
git commit

Sobald du dein Projekt eingerichtet hast, kannst du neue Dateien hinzufügen, indem du den entsprechenden Pfad an git add übergibst:

git add hello.py
git commit

Die obigen Befehle können auch zum Erfassen von Änderungen an bestehenden Dateien genutzt werden. Beachte, dass Git nicht zwischen Staging-Änderungen in neuen Dateien und Änderungen in Dateien, die dem Repository bereits hinzugefügt wurden, unterscheidet.


In review, git add is the first command in a chain of operations that directs Git to "save" a snapshot of the current project state, into the commit history. When used on its own, git add will promote pending changes from the working directory to the staging area. The git status command is used to examine the current state of the repository and can be used to confirm a git add promotion. The git reset command is used to undo a git add. The git commit command is then used to Commit a snapshot of the staging directory to the repositories commit history.

Du möchtest mit Git arbeiten?

Sieh dir dieses interaktive Tutorial an.

Jetzt loslegen