====== Git Troubleshooting ======
===== SSH‑Key‑Probleme =====
==== Problem: „Permission denied (publickey)“ ====
__Ursache__: Der SSH‑Key ist nicht im Agent, nicht auf dem Server oder du verwendest den falschen Key.

=== Lösungsschritte: ===
  - Prüfen, ob ein Key existiert
    <code bash>dir ~/.ssh</code>
    Erwartet: id_ed25519 und id_ed25519.pub
  - SSH‑Agent starten
    <code bash>eval $(ssh-agent -s)</code>
  - Key hinzufügen
    <code bash>ssh-add ~/.ssh/id_ed25519</code>
  - Public Key in Gitea eintragen
    * Gitea → Benutzerprofil → SSH‑Keys
    * Inhalt von id_ed25519.pub einfügen
  - Verbindung testen
    <code bash>ssh -T git@<dein-gitea-host></code>
    
==== Problem: „Host key verification failed“ ====
__Ursache__: Der Server ist neu oder der Fingerprint hat sich geändert.
=== Lösung: ===
<code bash>ssh-keygen -R <gitea-host>
ssh <gitea-host></code>
→ Fingerprint bestätigen

==== Problem: VS Code / Visual Studio nutzt falschen SSH‑Key ====
=== Lösung: ===
In //~/.ssh/config//:
<code bash>Host gitea
    HostName <dein-host>
    User git
    IdentityFile ~/.ssh/id_ed25519</code>
    
===== Merge‑Konflikte =====
==== Problem: „CONFLICT: Merge conflict in <datei>“ ====
__Ursache__: Zwei Personen haben dieselbe Stelle geändert.
== Konfliktmarkierungen im Code ==
<code bash><<<<<<< HEAD
deine Änderungen
=======
Änderungen vom anderen Branch
>>>>>>> feature/login</code>
=== Lösungsschritte: ===
  - Datei öffnen
  - Konfliktbereiche manuell korrigieren
  - Konfliktmarkierungen entfernen
  - Datei als gelöst markieren:
    <code bash>git add <datei></code>
  - Merge abschließen:
    <code bash>git commit</code>

==== Problem: Merge zu komplex / unübersichtlich ====
=== Lösung: ===
Merge abbrechen
<code bash>git merge --abort</code>

==== Problem: Visual Studio zeigt Konflikte nicht sauber an ====
=== Lösung: ===
  * Menü: **Git** → **Konflikte** → **Konflikt lösen**
  * Alternativ: VS Code öffnen (bessere Konfliktansicht)

===== Push‑Fehler =====
==== Fehler: „non-fast-forward“ oder „rejected“ ====
__Ursache__: Auf dem Server gibt es neue Commits, die du lokal nicht hast.
=== Lösung: ===
<code bash>git pull</code>
→ **Konflikte lösen** → **Commit** → **Push**

==== Fehler: „Updates were rejected because the remote contains ====
__Ursache__: Du hast lokal Commits, die nicht auf dem Server sind.
=== Lösung: ===
<code bash>git pull --rebase
git push</code>
=== Alternative (wenn Merge gewünscht) ===
<code bash>git pull
git push</code>

==== Fehler: „You are not allowed to push to this repository“ ====
__Ursache__:
  * Falscher Benutzer
  * Keine Schreibrechte
  * Falscher Branch (z. B. main geschützt)
=== Lösung: ===
  * Gitea → Repository → Settings → Branch Protection prüfen
  * Schreibrechte prüfen
  * Branch wechseln:
<code bash>git checkout <feature-branch></code>

==== Fehler: „fatal: Authentication failed“ ====
__Ursache__: Bei HTTPS: falsches Passwort oder Token fehlt.
=== Lösung: ===
  * In Gitea → Benutzerprofil → Tokens
  * Neuen Token erstellen
  * Git‑Credential‑Manager aktualisieren:
<code bash>git credential-manager reject https://<gitea-host></code>

===== Allgemeine Reparaturbefehle =====
==== Lokales Repo „reparieren“ ====
<code bash>git fetch --all
git reset --hard origin/main</code>

==== Staging zurücksetzen ====
<code bash>git restore --staged <datei></code>

==== Datei wiederherstellen ====
<code bash>git restore <datei></code>