GitHub einrichten und das Projekt verbinden

Danach können Sie

Sie haben ein privates Übungsrepository auf GitHub, eine lokale Kopie auf Ihrem Computer und denselben Ordner im Editor geöffnet. Eine kleine manuelle Änderung lässt sich nachvollziehen und auf GitHub wiederfinden.

Diese Anleitung verwendet GitHub Desktop für Git-Aktionen und VS Code als Editor. Die Übung enthält ausschliesslich selbst erfundene Projektinformationen. Bei einer bestehenden Anwendung beginnen Sie mit dem Abschnitt Vorhandenes Projekt.

Werkzeuge vorbereiten

1. Verwenden Sie ein für die Aufgabe freigegebenes GitHub-Konto. Bei einem Geschäftsprojekt klären Sie, welchem Firmenkonto beziehungsweise welcher Organisation das Repository gehören soll. Für die reine Übung können Sie ein eigenes privates Repository verwenden.
2. Installieren Sie GitHub Desktop von der offiziellen Seite und melden Sie sich darin bei GitHub an. Tragen Sie in den Git-Einstellungen den vorgesehenen Namen und die E-Mail-Adresse für Ihre Commits ein. Offizielle Einrichtung.
3. Installieren Sie VS Code. Wählen Sie das passende Installationspaket für Ihr Betriebssystem.
4. Für Git-Befehle im Editor oder durch ein KI-Werkzeug benötigen Sie auch ein zugängliches Git auf der Befehlszeile. GitHub Desktop bringt seine eigene Git-Nutzung mit; das bedeutet nicht automatisch, dass ein anderer Editor Git findet. Verwenden Sie bei Bedarf die offizielle Git-Installation.

Zur Kontrolle öffnen Sie in VS Code Terminal → New Terminal. Ein Terminal ist ein Fenster für eingegebene Befehle. Geben Sie ein:

git --version

Erwartet wird eine Versionsangabe. Wenn der Befehl nicht gefunden wird, folgen Sie der Git-Installationsanleitung für Ihr System und öffnen Sie den Editor danach neu. Installieren Sie noch keine Programmiersprache nur wegen dieser Übung; für eine echte App nennt deren README die benötigte Laufzeit.

Ein neues Übungsrepository anlegen

Auf GitHub wählen Sie New repository. Prüfen Sie den Eigentümer, nennen Sie das Projekt meine-uebungs-app, wählen Sie Private und lassen Sie eine README anlegen. Für diese neue Übung brauchen Sie keine vorhandene Anwendung zu importieren. Erstellen Sie das Repository. GitHub: neues Repository.

Notieren Sie die entstandene Adresse, beispielsweise https://github.com/IHR-KONTO/meine-uebungs-app. Das ist die Adresse des Repositorys, nicht die Adresse einer bereits laufenden App.

Die lokale Kopie verbinden

Öffnen Sie in GitHub Desktop File → Clone Repository. Wählen Sie das neue Repository oder tragen Sie seine Adresse unter URL ein. Legen Sie einen lokalen Ordner ausserhalb bereits vorhandener Projekte fest und wählen Sie Clone. Damit wird die vorhandene Repository-Geschichte auf Ihren Computer geholt. Offizielle Clone-Anleitung.

Öffnen Sie genau diesen Ordner in VS Code über File → Open Folder. Alternativ wählen Sie VS Code in GitHub Desktop als Editor. Kontrollieren Sie den Ordnernamen und die README im Dateibaum.

Die Verbindung mit einer kleinen Änderung prüfen

Ergänzen Sie in der lokalen README eine harmlose Zeile wie «Dieses Repository ist mein Übungsprojekt» und speichern Sie die Datei. In GitHub Desktop sollte die Änderung unter Changes erscheinen. Lesen Sie den angezeigten Unterschied. Speichern Sie die Änderung mit einer verständlichen Commit-Beschreibung und senden Sie sie mit Push origin zu GitHub.

Öffnen Sie das Repository im Browser und laden Sie die README neu. Die Zeile und der Commit müssen dort erscheinen. Commits und Diff in GitHub Desktop.

Vorhandenes Projekt

Es gibt bereits ein Repository: Verwenden Sie dessen Adresse und klonen Sie es. Liegt es bereits lokal vor, nehmen Sie den bestehenden Ordner über File → Add Local Repository in GitHub Desktop auf. Öffnen Sie denselben Ordner im Editor. Prüfen Sie die bisherige Verbindung, bevor Sie eine neue erstellen. Lokales Repository hinzufügen.

Es gibt lokale Dateien, aber noch kein Repository: Sichern Sie zuerst die vorhandenen Dateien und prüfen Sie, was davon ins Repository gehört. Lassen Sie ein neues Git-Repository in genau diesem Projektordner anlegen, beispielsweise über die Git-Funktion des Editors. Danach können Sie es in GitHub Desktop aufnehmen und nach Prüfung der Dateien privat veröffentlichen. Behalten Sie dabei die vorgesehenen Eigentums- und Zugriffsverhältnisse bei. Git im Editor.

Die App wurde in einem Browser-Werkzeug erstellt: Klären Sie zunächst dessen tatsächliche GitHub-Anbindung oder Exportmöglichkeit. Suchen Sie das bereits verknüpfte Repository. Erstellen Sie nicht zusätzlich eine getrennte Codekopie, wenn damit unklar würde, welche Version die laufende App speist.

In einem bestehenden Projekt sollten Sie weder die .git-Struktur löschen noch Verbindungen oder Geschichte pauschal ersetzen. Ein vorhandener Konflikt benötigt zuerst eine Erklärung, welche Änderungen erhalten werden sollen.

Dateien vor dem Teilen prüfen

Eine .gitignore beschreibt Dateien, die Git bei neuen Änderungen ignorieren soll. Für lokale Umgebungsdateien kann ein Ausgangspunkt so aussehen:

.env
.env.*
!.env.example

Die Datei .env.example darf dabei nur Beispiele und Platzhalter enthalten. Weitere Regeln hängen von der tatsächlichen Anwendung ab. Bereits gespeicherte Geheimnisse werden durch diese Regeln nicht aus der Geschichte entfernt. GitHub: Dateien ignorieren.

Erfolgskontrolle

Sie kennen Eigentümer, Repository-Adresse und lokalen Ordner. Eine eigene harmlose Änderung ist lokal und auf GitHub sichtbar. Git wird im Editor gefunden. Der Übungsordner enthält keine fremden Projektdateien, Kundendaten oder Zugangsdaten. Damit können Sie ein KI-Werkzeug einrichten.