So laden Sie als Anfänger ein Projekt auf Github hoch

Jeder Entwickler oder Fachmann in der Welt der Technologie weiß, was es ist GitHubAllerdings beherrscht nicht jeder den Prozess der ein Projekt auf Github hochladen und nutzen Sie das Potenzial dieser Plattform hinsichtlich Versionskontrolle, Teamzusammenarbeit und professioneller Transparenz voll aus.

In diesem Sinne fühlen sich sowohl Anfänger als auch Experten oft etwas verloren. In diesem Artikel erfahren Sie Wir sagen Ihnen, wie es geht, denn Es gibt mehrere Optionen oder MethodenWenn Sie Ihr Projekt für die Zusammenarbeit oder zum einfachen Anzeigen und Herunterladen durch andere verfügbar machen möchten, lesen Sie weiter, um alle Einzelheiten zu erfahren.

Was ist ein Repository und warum sollte man es auf GitHub hosten?

Un Aufbewahrungsort Es ist der virtuelle Raum, in dem die Dateien und Ordner Ihres Projekts gespeichert werden, zusammen mit der Historie der Änderungen, die im Laufe der Entwicklung an ihnen vorgenommen werden. Diese Historie ermöglicht Verwalten Sie Versionen, kehren Sie zu früheren Zuständen zurück, arbeiten Sie mit anderen zusammen und dokumentieren Sie Ihren Arbeitsfortschritt klar und deutlich..

Hosten Sie ein Repository auf GitHub Es hat mehrere Vorteile:

• Versionskontrolle: Ihre Änderungen werden aufgezeichnet und Sie können jeden Teil der Entwicklung rückgängig machen, überprüfen oder freigeben.
• Datensicherung in der Cloud: Sie vermeiden den Verlust wichtiger Informationen im Falle eines Vorfalls vor Ort.
• Professionelle Sichtbarkeit: Da Ihre Arbeit öffentlich ist, kann jeder sie sehen, was Ihr Portfolio aufwertet.
• Einfache Zusammenarbeit: GitHub macht es anderen leicht, durch Pull Requests, Issues oder Forks zu Ihrem Projekt beizutragen.

Erste Schritte: Voraussetzungen und Umgebungsvorbereitung

Stellen Sie vor dem Hochladen eines Projekts auf Github sicher, dass Folgendes auf Ihrem Computer installiert ist:

• Konto auf GitHub. Es ist wichtig, Repositories auf der Plattform zu erstellen.
• Git installiert. Es ist das grundlegende Versionskontrolltool, mit dem Sie Änderungen verwalten können. Sie können es von seinem herunterladen und installieren Offizielle WebsiteAuf Linux-basierten Systemen können Sie die Installation durchführen, indem Sie den Befehl sudo apt-get install git Im Terminal.
• Code-Editor oder IDE. Optionen wie Visual Studio Code (VSCode) vereinfachen den Vorgang. Wenn Sie die Vorteile der direkten Integration mit GitHub vom Editor aus nutzen möchten, empfiehlt es sich, eines dieser Tools herunterzuladen.

Einmal installiert Git auf Ihrem System ist der erste Schritt die Konfiguration mit Ihrem Name und E-Mail (Diese Daten werden zum Signieren Ihrer Commits verwendet.) Führen Sie im Terminal Folgendes aus:

git config --global user.name "TuNombre"
git config --global user.email [email protected]

Diese Einstellung ist globale und Sie müssen es nur einmal in Ihrem Team tun.

Erstellen des Repository auf GitHub

Jetzt ist es an der Zeit, den Ort zu erstellen, an dem Sie Ihr Projekt hosten. Führen Sie dazu die folgenden Schritte über die GitHub-Weboberfläche aus:

1. Greifen Sie auf Ihr Profil zu in GitHub.com und klicke auf den Button "Neu" um ein neues Repository zu erstellen.
2. Geben Sie die Name für das Repository gewünscht und fügt eine beschreibung kurz, aber konkret über den Zweck des Projekts.
3. Wählen Sie, ob das Repository öffentlich oder privatWenn Sie möchten, dass auch andere die Anzeige und Teilnahme ermöglichen, wählen Sie „Öffentlich“ aus.
4. Sie haben die Möglichkeit, eine Datei zu erstellen README.md automatisch. Diese Datei wird empfohlen, da sie das Erste ist, was andere Entwickler sehen, wenn sie auf das Repository zugreifen.
5. Klicken Sie auf «Repository erstellen» um den Vorgang abzuschließen und Ihr Repository ist bereit, Dateien zu empfangen.

Vorbereiten Ihres lokalen Projekts für den Upload auf GitHub

Nachdem Ihr Repository erstellt wurde, müssen Sie im nächsten Schritt zum Hochladen eines Projekts auf GitHub Ihren Projektordner auf Ihrem Computer vorbereiten. Folgen Sie dazu den Anweisungen im Terminal und suchen Sie zunächst den richtigen Pfad mit cd:

cd tu-carpeta-del-proyecto

Initialisieren Sie nun das lokale Git-Repository:

git init

Dadurch wird ein versteckter Ordner mit dem Namen erstellt .git das speichert die Versionsgeschichte und andere interne Dateien.

 

Hochladen des Codes auf GitHub: der vollständige Vorgang im Terminal

Sobald das lokale Repository initialisiert ist, laden wir den gesamten Inhalt auf GitHub hoch, indem wir diese Befehle ausführen:

1. Alle Dateien zum Staging-Bereich hinzufügen mit:

git add .

2. Machen Sie eine Verpflichtung So zeichnen Sie den ersten Kontrollpunkt auf:

git commit -m "Primer commit"

3. Verknüpfen Sie das lokale Repository mit dem Remote-Repository. Ersetzt NOMBRE_USUARIO y NOMBRE_REPOSITORIO durch reale Daten:

git remote add origin https://github.com/NOMBRE_USUARIO/NOMBRE_REPOSITORIO.git

4. Änderungen auf GitHub hochladen (Zweig main o master je nach Bedarf):

git push -u origin main

In einigen älteren Repositories oder Konfigurationen ist der Hauptzweig master statt mainWenn Fehler auftreten, überprüfen Sie den Namen des Hauptzweigs und ersetzen Sie ihn im obigen Befehl.

So laden Sie Projekte von VSCode auf Github hoch

Moderne Editoren wie VSCode Sie bieten eine native Integration mit Git und GitHub. So geht's ganz einfach:

• Öffnen Sie Ihren Projektordner im Editor („Datei → Ordner öffnen“).
• Greifen Sie auf das Dashboard zu Quellcodeverwaltung (Quellcodeverwaltung) in der Seitenleiste.
• Klicken Sie auf "Repository initialisieren", falls Sie dies noch nicht getan haben. Dies entspricht dem Befehl git init.
• Nach der Initialisierung sehen Sie eine Schaltfläche zum Auf GitHub veröffentlichenWenn Sie dies zum ersten Mal tun, müssen Sie die Verbindung zwischen VSCode und Ihrem GitHub-Konto autorisieren.
• Wählen Sie, ob das Repository öffentlich oder privat veröffentlicht werden soll.
• Bereiten Sie die Dateien für das erste Commit vor, indem Sie die Änderungen markieren und eine beschreibende Nachricht hinzufügen.
• Veröffentlichen Sie Ihr Projekt und Sie können Änderungen ganz einfach vom Editor aus synchronisieren.

Diese Option ist perfekt für diejenigen, die lieber in der Entwicklungsumgebung bleiben möchten, und erleichtert das tägliche Projektmanagement erheblich.

Dateien manuell von der GitHub-Website hochladen

Eine weitere Alternative, insbesondere für kleine Projekte, besteht darin, Dateien manuell über die Weboberfläche hochzuladen:

1. Geben Sie das neu erstellte Repository auf GitHub ein.
2. Klicken Sie auf das Dropdown-Menü «Datei hinzufügen» und wählen Sie Dateien hochladen.
3. Ziehen Sie Dateien oder Ordner per Drag & Drop von Ihrem Computer in das Browserfenster.
4. Fügen Sie unten eine Bestätigungsnachricht hinzu und klicken Sie auf Änderungen festschreiben um die Dateien hochzuladen.

Diese Methode ist für Projekte in der aktiven Entwicklung weniger effizient, aber nützlich zum Hinzufügen bestimmter Dateien, Dokumentationen und anderer Elemente.

Erweiterte Verwaltung und bewährte Methoden bei der Arbeit mit GitHub

Das Hochladen eines Projekts ist nur der Anfang. Um GitHub optimal zu nutzen und eine professionelle Organisation aufrechtzuerhalten, empfehlen wir die folgenden zusätzlichen Best Practices:

• Halten Sie README.md auf dem neuesten Stand. Dies ist das Anschreiben Ihres Projekts. Es erläutert dessen Zweck, Installation, Verwendung und alle relevanten Details. Sie können es direkt online oder in Ihrem Editor mit Markdown-Syntax bearbeiten.
• Erstellen Sie Arbeitszweige. Nehmen Sie nicht alle Änderungen in „main“ oder „master“ vor. Verwenden Sie separate Branches für neue Funktionen oder Fehlerbehebungen. Sie können diese später mithilfe von Pull Requests zusammenführen.
• Hochladen von .gitignore-Dateien um die Weitergabe vertraulicher oder automatisch generierter Daten wie node_modules-Ordner, temporärer Dateien oder lokaler Konfigurationsdateien zu vermeiden.
• Synchronisieren Sie regelmäßig Ihre lokalen und Remote-Repositorys. Verwenden git pull um Ihre lokale Kopie mit allen Änderungen, die möglicherweise von Mitwirkenden vorgenommen wurden, auf dem neuesten Stand zu halten.
• Gehen Sie mit Fernbedienungen sorgfältig um. Wenn Sie die Remote-Quelle ändern, verwenden Sie git remote -v die zugehörigen Repositorien zu überprüfen und git remote remove origin um sie gegebenenfalls zu entfernen.

Projekte klonen und gemeinsam daran arbeiten: der nächste Schritt

Sobald sich Ihr Repository in der Cloud befindet, können Sie es mit folgendem Befehl auf jeden anderen Computer klonen:

git clone https://github.com/TU_USUARIO/TU_REPOSITORIO.git

Dadurch wird eine lokale Kopie Ihres Projekts erstellt, einschließlich aller ÄnderungsverlaufWenn Sie dem Ordner einen anderen Namen geben möchten, können Sie ihn am Ende des Befehls hinzufügen. Um zu verhindern, dass der Befehl einen neuen Ordner erstellt und Dateien direkt im aktuellen Verzeichnis ablegt, fügen Sie einen Punkt hinzu:

git clone https://github.com/TU_USUARIO/TU_REPOSITORIO.git .

Bei der Zusammenarbeit mit anderen Nutzern auf GitHub geht es vor allem darum, den Ablauf von Branches, Pull Requests und Code-Reviews zu verstehen. Auf diese Weise können Sie externe Beiträge akzeptieren und organisiert und effizient im Team arbeiten.

Häufige Fehler und wie man sie behebt

Beim Hochladen eines Projekts können häufige Probleme auftreten. Hier sind die häufigsten und ihre Lösung:

• Versuch, in ein leeres Repository ohne Master-Zweig zu pushen– Wenn das Remote-Repository ohne README.md erstellt wurde und noch nie ein Zweig gepusht wurde, stellen Sie sicher, dass Sie den ersten Zweig mit dem richtigen Namen pushen, normalerweise „main“ oder „master“.
• Synchronisierungskonflikte: Wenn es gleichzeitig Änderungen lokal und remote gibt, lösen Sie diese, indem Sie zuerst eine git pull und Konflikte zu lösen, bevor man git push wieder.
• Nicht ausreichende Berechtigungen: Stellen Sie sicher, dass Sie über die richtigen Anmeldeinformationen verfügen, und überprüfen Sie, ob die Remote-URL richtig geschrieben ist (https oder ssh, je nach Bedarf).
• Vergessen, wichtige Dateien hinzuzufügen: Überprüfen und aktualisieren Sie Ihre Datei .gitignore um keine wichtigen Dateien auszulassen oder versehentlich private Informationen hochzuladen.

Das Hochladen Ihres Projekts auf GitHub verändert Ihren Arbeitsablauf grundlegend: Sie können jederzeit frühere Versionen wiederherstellen, zusammenarbeiten und Ihre Arbeit der Welt präsentieren.