Quelltext der Seite Git-Spickzettel

= Git – Spickzettel für den Alltag =

Ich bin vergesslich! Leider. 🥲
Daher ein kurzer Überblick über die wichtigsten Git-Befehle für kleine Projekte (z. B. meinen Chatti-Client, Tuxi-Skripte, Wiki-Helferlein).
Fokus: „Ich ändere manchmal Code, will ihn sauber committen und zu GitHub schieben – wie war das nochmal?“

Hier geht's um den Umgang mit einem laufenden Git. Zum Einrichten ist ein SSH-Kanal nötig. Zum Umgang mit SSH gibt's eine [[SSH|eigene SSH-Seite]]. Die enthält auch einen Abschnitt über SSH in Verbindung mit dem GitHub.

== Grundbegriffe (in sehr kurz) ==

; Repository (Repo)
: Projektordner mit Git-Historie. Enthält ein Unterverzeichnis <code>.git</code>.

; Commit
: „Schnappschuss“ des Projektzustands mit Nachricht. Mehrere Commits bilden die Historie.

; Branch
: „Arbeitslinie“. Meist heißt der Hauptbranch <code>main</code> (früher oft <code>master</code>).

; Remote
: Entferntes Repo (z. B. auf GitHub). Standardname meistens <code>origin</code>.

== Typischer Workflow nach Code-Änderungen ==

=== 1. Status prüfen ===

<pre>
git status
</pre>

Zeigt:
* welche Dateien geändert wurden,
* ob etwas zum Commit vorgemerkt ist,
* auf welchem Branch du bist.

=== 2. Änderungen für Commit vormerken (stagen) ===

Alles (schnell und bequem):

<pre>
git add .
</pre>

Oder gezielt (empfohlen bei größeren Projekten):

<pre>
git add pfad/zur/datei.py
git add docs/README.md
</pre>

=== 3. Commit erstellen ===

<pre>
git commit -m "Kurz und sinnvoll beschreiben, was sich geändert hat"
</pre>

Beispiele:
* <code>git commit -m "fix: Timeout im Doctor reduziert"</code>
* <code>git commit -m "docs: Tuxipedia-Artikel verlinkt"</code>

=== 4. Änderungen nach GitHub pushen ===

Wenn der Branch schon einen Remote-Branch hat (z. B. main → origin/main):

<pre>
git push
</pre>

Falls Git meckert, dass kein Upstream gesetzt ist, einmalig:

<pre>
git branch --show-current      # aktuellen Branch anzeigen (z. B. main)
git push -u origin main        # Branch 'main' mit origin verknüpfen
</pre>

Danach reicht wieder einfach <code>git push</code>.

== Änderungen ansehen ==

=== Welche Dateien sind geändert? ===

<pre>
git status
</pre>

=== Inhaltliche Unterschiede anzeigen (Diff) ===

Alle Änderungen im Arbeitsverzeichnis:

<pre>
git diff
</pre>

Nur Änderungen in bereits gestagten Dateien:

<pre>
git diff --cached
</pre>

Diff für eine Datei:

<pre>
git diff pfad/zur/datei.py
</pre>

== Änderungen zurücknehmen (vorsichtig) ==

=== Datei aus dem Index (Staging) zurückholen ===

Falls man sich beim <code>git add</code> vertan hat:

<pre>
git restore --staged pfad/zur/datei.py
</pre>

Änderungen bleiben in der Datei, sind nur nicht mehr „zum Commit vorgemerkt“.

=== Lokale Änderungen an einer Datei verwerfen ===

Achtung: Nicht rückgängig zu machen, wenn man keinen Backup hat.

<pre>
git restore pfad/zur/datei.py
</pre>

Die Datei wird auf den Stand des letzten Commits zurückgesetzt.

== Remote & Aktualisieren (pull) ==

=== Änderungen von GitHub holen und einspielen ===

<pre>
git pull
</pre>

Üblicher Ablauf:
* Git holt neue Commits von origin
* ggf. werden sie in deinen aktuellen Branch gemerged

=== Neues Projekt von GitHub klonen ===

<pre>
git clone https://github.com/USER/REPO.git
</pre>

Optional mit Zielordner:

<pre>
git clone https://github.com/USER/REPO.git mein-ordner
</pre>

== Branches (nur das Nötigste) ==

=== Neuen Branch erstellen und wechseln ===

<pre>
git switch -c feature/irgendwas
</pre>

=== Auf bestehenden Branch wechseln ===

<pre>
git switch main
</pre>

(Alternativ geht auch noch <code>git checkout</code>, aber <code>git switch</code> ist moderner und klarer.)

== Bei Konflikten (nur ganz grob) ==

Konflikte entstehen, wenn <code>git pull</code> oder ein Merge Änderungen zusammenführen soll, die sich widersprechen.

Typischer Ablauf:

# <code>git pull</code> ausführen
# Git meldet „merge conflict“ und kennzeichnet Stellen im Code mit <code>&lt;&lt;&lt;&lt;&lt;&lt;&lt;</code> und <code>&gt;&gt;&gt;&gt;&gt;&gt;&gt;</code>
# Datei im Editor öffnen, Konfliktstellen manuell auflösen
# gelöste Dateien wieder vormerken:
   <pre>git add pfad/zur/datei.py</pre>
# Merge abschließen:
   <pre>git commit</pre>

Falls es zu kompliziert wird: lieber kurz pausieren, nachdenken, diff ansehen – oder Rücksprache mit dem zukünftigen Ich halten. ;)

== Minimal-Workflow zum Merken ==

Der „Minimal-Spickzettel“, wenn du nur kurz was ändern willst:

<pre>
git status
git add .
git commit -m "kurze Beschreibung"
git push
</pre>

Damit erledigst du 95 % der alltäglichen Git-Aufgaben.