Uber è un'azienda tecnologica con sede nella Silicon Valley, USA, ed è stata una delle prime ad adottare il linguaggio Go. Ha reso open source molti progetti golang, come i ben noti zap e jaeger nella community Gopher. Alla fine del 2018, Uber ha reso open source la propria guida stilistica interna per Go su GitHub. Dopo un anno di accumulo e aggiornamenti, la guida ha preso forma e ha ricevuto ampia attenzione dai Gophers. Questo articolo è la versione cinese della guida.
Lo stile del codice governa le convenzioni che controllano il nostro codice. Queste convenzioni coprono non solo il formato del file sorgente gestito da gofmt per noi.
Lo scopo di questa guida è gestire questa complessità descrivendo dettagliatamente le considerazioni per scrivere codice Go in Uber. L'esistenza di queste regole è quella di rendere la base del codice facile da gestire consentendo comunque agli ingegneri di utilizzare più efficacemente le caratteristiche del linguaggio Go.
La guida è stata inizialmente scritta da Prashant Varanasi e Simon Newton con l'obiettivo di consentire ai colleghi di utilizzare rapidamente Go. Nel corso degli anni, la guida è stata modificata in base ai feedback degli altri.
Questo documento registra le convenzioni idiomatiche nel codice Go che seguiamo in Uber. Molte di queste sono linee guida generali per Go, mentre altre linee guida estese dipendono dai seguenti guide esterne:
Il nostro obiettivo è rendere gli esempi di codice adatti all'uso con due rilasci di Go rilasci.
Tutto il codice dovrebbe superare i controlli di golint
e go vet
senza errori. Raccomandiamo di impostare il tuo editor per:
- Eseguire
goimports
al salvataggio - Eseguire
golint
ego vet
per il controllo degli errori
Repository GitHub: https://github.com/uber-go/guide
Repository GitHub: https://github.com/xxjwxc/uber_go_guide_cn