Guida Completa a GitHub per Principianti

1. Cos’è GitHub?

GitHub è una piattaforma basata su Git, un sistema di controllo versione distribuito.

• Repository (repo): Cartella del progetto che contiene tutti i file e la cronologia delle modifiche.
• Commit: Snapshot delle modifiche al codice.
• Branch: Copia separata del codice per sviluppare funzionalità senza influenzare la versione principale.
• Pull Request (PR): Richiesta per unire modifiche da un branch a un altro.

2. Configurazione Iniziale

Installare Git

• Windows: Scarica da git-scm.com
• Mac: 

brew install git

• Linux: 

sudo apt install git

Verifica installazione:

git --version

Configurare Git

git config --global user.name "Tuo Nome"
git config --global user.email "tua@email.com"

Collegare SSH a GitHub

1. Genera una chiave SSH:

   ssh-keygen -t ed25519 -C "tua@email.com"

2. Aggiungi la chiave pubblica (~/.ssh/id_ed25519.pub) su GitHub:

   Settings > SSH and GPG keys > New SSH key

3. Comandi Git Base

• Inizializzare un Repository

git init               # Crea un nuovo repository GIT nella cartella corrente
git clone <url-repo>   # Scarica una copia di un repository remoto

• Aggiungere e Salvare Modifiche:

git status                # Mostra lo stato dei file
git add <file>            # Aggiunge un file da tracciare
git add .                 # Aggiunge TUTTI i file modificati
git commit -m "messaggio" # Salva le modifiche del repository locale con un messaggio

• Inviare Modifiche a GitHub :

git push origin main      # Carica le modifiche su GitHub
git pull origin main      # Scarica le modifiche da GitHub

• Vedere la cronologia dei commit

git log                   # Mostra tutti i commit effettuati nel repository.

4. Flusso di Lavoro su GitHub

• Fai un fork del repository (se non hai accesso diretto).
• Clona il repo:

git clone https://github.com/tuo-username/repo.git

• Crea un branch per la tua modifica:

git checkout -b feature/nuova-funzione

• Fai commit e push:

git add .
git commit -m "Aggiunta nuova funzione"
git push origin feature/nuova-funzione

• Apri una Pull Request su GitHub per chiedere di unire le modifiche.

5. Branch e Merge

• Gestione dei Branch: 

git branch                  # Lista dei branch
git checkout <branch>       # Passa a un branch esistente
git merge <branch>          # Unisce un branch al branch corrente

• Esempio di Merge: 

git checkout main           # Torna al branch principale
git merge feature/nuova-funzione  # Unisci le modifiche
git push origin main        # Aggiorna il repo remoto

6. Collaborazione su GitHub

• Issues: Segnalare bug o richiedere nuove funzionalità.
• Pull Requests: Proporre modifiche al codice.
• Code Review: Approvare o commentare modifiche prima del merge.

7. Comandi Avanzati

• Ripristinare Modifiche:  

git reset --hard HEAD       # Annulla tutte le modifiche non committate
git checkout -- <file>      # Ripristina un file modificato

• Stash (Salvataggio Temporaneo): 

git stash                   # Salva le modifiche in sospeso
git stash pop               # Ripristina le modifiche salvate

• Rebase (Riordinare Commit): 

git rebase main             # Aggiorna il branch con le modifiche di main

Conclusione

GitHub è uno strumento essenziale per sviluppatori. Con questa guida, puoi iniziare a collaborare su progetti, gestire il codice e contribuire alla community open source! 🚀

🔗 Risorse Utili:

• Documentazione Ufficiale Git

• GitHub Guides