Caricare un progetto su GitHub: passo dopo passo
Vi guidiamo nella creazione di un nuovo repository GitHub, nel collegamento del progetto locale, nel primo commit e push, e nelle alternative GitHub Desktop e gh CLI.

Per caricare un progetto su GitHub, create prima un repository vuoto su github.com. Nella cartella del progetto registrate il primo snapshot con git init, git add . e git commit, collegate il repository con git remote add origin, quindi inviatelo con git push -u origin main. GitHub Desktop o il comando gh repo create fanno lo stesso lavoro senza riga di comando.
Che cosa serve prima di iniziare
Caricare un progetto su GitHub significa trasformare una cartella del vostro computer in un repository Git e collegarla a un repository remoto online. Devono essere pronte tre cose: Git installato e configurato, un account GitHub e un metodo di autenticazione.
Se non avete ancora installato Git, o non avete impostato nome, e-mail e chiave SSH, partite dalla nostra guida all'installazione di Git. I comandi di questo articolo presuppongono che queste impostazioni siano già fatte.
- Git: eseguendo git --version nel terminale dovrebbe comparire un numero di versione.
- Account GitHub: potete aprirne uno gratuitamente su github.com.
- Autenticazione: una chiave SSH oppure, per HTTPS, Git Credential Manager o un personal access token. GitHub non accetta la password del vostro account per le operazioni Git.
- Una cartella di progetto pulita: un file .gitignore per escludere i file inutili e riservati.
Creare un repo su GitHub
Accedete a GitHub, cliccate sull'icona più in alto a destra e scegliete New repository. Usate un nome di repository breve e in minuscolo (per esempio company-site), aggiungete una descrizione e scegliete la visibilità.
Se avete già un progetto sul computer, non aggiungete README, .gitignore o licenza; create il repository completamente vuoto. In caso contrario il repository remoto riceve un commit che non esiste in locale e il primo push va in conflitto.
| Visibilità | Chi può vederlo | Quando sceglierlo |
|---|---|---|
| Public | Tutti | Progetti open source, lavori di portfolio |
| Private | Solo voi e le persone che invitate | Progetti dei clienti, codice interno dell'azienda |
Escludere i file indesiderati con .gitignore
Prima del primo commit, la cosa più importante è decidere quali file devono restare fuori dal repository. node_modules, le cartelle di build, i file del sistema operativo e soprattutto i file .env con password o chiavi API non devono mai essere caricati su GitHub.
Create un file chiamato .gitignore nella radice del progetto e aggiungete righe come quelle qui sotto. Spieghiamo perché le dipendenze restano fuori dal repository, e il ruolo di package.json, nel nostro articolo sui comandi npm.
- Se avete fatto commit di un file riservato per errore, eliminarlo in seguito non basta; il file resta nella cronologia. Cambiate subito la chiave o la password.
- Per smettere di tracciare una cartella già tracciata, usate git rm -r --cached folder-name, poi aggiungetela a .gitignore e fate commit.
node_modules/ dist/ build/ .env .env.* .DS_Store Thumbs.db *.logIl primo caricamento da riga di comando
Nel terminale, spostatevi nella cartella del progetto ed eseguite in ordine i comandi qui sotto. L'indirizzo del repository remoto si trova nella pagina del repository vuoto su GitHub, sotto il pulsante Code; copiate l'indirizzo SSH se avete configurato una chiave SSH, oppure quello HTTPS in caso contrario.
- Trasformate la cartella in un repository Git con git init.
- Aggiungete tutti i file all'area di staging con git add ..
- Create il primo snapshot con git commit.
- Fissate il nome del branch come main.
- Collegate il repository remoto con git remote add origin.
- Inviate con git push -u origin main; l'opzione -u vi permette di scrivere solo git push la volta successiva.
cd proje-klasoru git init git add . git commit -m "First commit" git branch -M main # SSH adresi git remote add origin git@github.com:kullanici-adi/depo-adi.git # ya da HTTPS adresi # git remote add origin https://github.com/kullanici-adi/depo-adi.git git push -u origin maingit remote -v git status git log --onelineCaricare con GitHub Desktop e gh CLI
La riga di comando non è l'unica strada. GitHub Desktop è adatto a chi preferisce un'interfaccia visiva, mentre gh, lo strumento da riga di comando ufficiale di GitHub, è adatto a chi vuole lavorare più in fretta nel terminale; entrambi fanno lo stesso lavoro in pochi passaggi.
GitHub Desktop
Installate GitHub Desktop e accedete con il vostro account. Dal menu File scegliete Add local repository e selezionate la cartella del progetto; se la cartella non è ancora un repository, l'app propone di crearne uno. Le modifiche appaiono nel pannello a sinistra, scrivete un messaggio nella casella in basso e premete Commit. Infine, il pulsante Publish repository crea il repository su GitHub e vi invia il codice.
gh CLI
Con gh, creare, collegare e inviare il repository si riduce a un unico comando. Al primo utilizzo si accede tramite il browser con gh auth login.
gh auth login # When the folder has at least one commit gh repo create depo-adi --private --source=. --remote=origin --pushCon VS Code
Il pulsante Publish to GitHub nel pannello del controllo del codice sorgente di VS Code offre lo stesso flusso. Per la configurazione dell'editor e l'integrazione con Git, vedete la nostra guida all'installazione di VS Code.
Come si inviano gli aggiornamenti?
Dopo il primo caricamento, la routine quotidiana si riduce a tre comandi: aggiungere le modifiche all'area di staging, salvarle, inviarle. Se lavorate su un altro computer, o un collega ha fatto modifiche, scaricate l'ultima versione con git pull prima di iniziare.
Scrivete messaggi di commit brevi e significativi: qualcosa come “aggiunto il campo telefono al modulo di contatto” invece di “update”. Tra sei mesi, questi messaggi vi diranno che cosa è cambiato e perché.
git pull git add . git commit -m "Add phone field to contact form" git pushLavorare con i branch
Invece di fare una grande modifica direttamente sul branch main, aprite un nuovo branch: git switch -c new-feature. Inviatelo con git push -u origin new-feature e aprite una pull request su GitHub. La modifica viene rivista prima del merge e il branch main resta sempre in uno stato funzionante.
Errori di push comuni e soluzioni
La maggior parte degli errori nei primi tentativi di push dipende dall'autenticazione, dal nome del branch o da commit inattesi sul repository remoto.
- src refspec main does not match any: non c'è ancora nessun commit, oppure il vostro branch si chiama master. Fate un commit con git commit, oppure rinominate il branch con git branch -M main.
- remote origin already exists: il remote è già definito. Per cambiare l'indirizzo, usate git remote set-url origin new-address.
- rejected (fetch first / non-fast-forward): il remoto ha un commit che non avete in locale, di solito un README creato su GitHub. Scaricatelo con git pull --rebase origin main e inviate di nuovo. Se le cronologie sono del tutto indipendenti, potrebbe servire git pull origin main --allow-unrelated-histories.
- Permission denied (publickey): la vostra chiave SSH non è stata aggiunta all'account; verificatela con ssh -T git@github.com.
- Large file error: GitHub rifiuta i singoli file superiori a 100 MB. Rimuovete dal repository video e backup oppure usate Git LFS.
Che cosa aggiunge GitHub ai progetti aziendali?
Tenere il codice su GitHub significa che il progetto non va perso se un computer si guasta o scompare. Soprattutto, poiché ogni modifica è tracciabile, quando un bug arriva sul sito online potete trovare rapidamente quale commit lo ha causato e annullarlo.
Quando i miglioramenti di velocità e prestazioni di un sito web, come la compressione delle immagini e la minificazione del codice, vengono salvati in commit separati, è facile misurare quanto ciascuno ha cambiato. Lavoriamo con questa disciplina nei nostri progetti di sito web aziendale e web design.
Non dimenticate di aggiungere al repository un file README scritto bene. Qualche paragrafo che spiega che cosa fa il progetto, come si installa e quale comando lo avvia fa risparmiare ore di lavoro a un nuovo membro del team, o a voi quando tornate dopo mesi. Elencate le variabili d'ambiente solo per nome, mai con i loro valori.
Per altre guide passo passo, sfogliate la categoria guide all'installazione.
Domande frequenti
01Caricare un progetto su GitHub costa qualcosa?
No. Con il piano gratuito di GitHub potete creare repository pubblici e privati illimitati. I piani a pagamento si scelgono soprattutto per esigenze come la gestione del team, la sicurezza avanzata e minuti di automazione aggiuntivi.
02Posso caricare un progetto con il drag and drop?
Potete caricare file nell'interfaccia web di GitHub con Add file > Upload files. Tuttavia questo metodo è limitato per numero e dimensione dei file e non è pratico per aggiornamenti regolari; usare Git o GitHub Desktop è molto più semplice sul lungo periodo.
03Ho caricato per errore un file contenente una password. Che cosa devo fare?
Per prima cosa cambiate subito quella password o chiave API; eliminare il file non rimuove la copia nella cronologia. Poi aggiungete il file a .gitignore e, se necessario, seguite la guida di GitHub sulla rimozione dei dati sensibili per ripulire la cronologia.
Caricare un progetto su GitHub richiede pochi minuti con un repository vuoto, un .gitignore pulito e qualche comando Git, e da quel momento ogni modifica viene registrata in modo sicuro. Se state pianificando un progetto software o web su misura per la vostra azienda, costruito con il controllo di versione, scoprite le soluzioni software su misura di Aurora Yazılım oppure contattateci.


