Uber est une entreprise technologique basée dans la Silicon Valley, aux États-Unis, et a été parmi les premiers à adopter le langage Go. Elle a open-sourcé de nombreux projets golang, tels que les bien connus zap et jaeger au sein de la communauté Gopher. À la fin de 2018, Uber a open-sourcé son guide de style Go interne sur GitHub. Après un an d'accumulation et de mises à jour, le guide s'est concrétisé et a reçu une attention considérable de la part des Gophers. Cet article est la version chinoise du guide.
Le style de code régit les conventions qui contrôlent notre code. Ces conventions couvrent non seulement le format de fichier source géré par gofmt pour nous.
Le but de ce guide est de gérer cette complexité en décrivant en détail les considérations pour écrire du code Go chez Uber. L'existence de ces règles vise à rendre la base de code facile à gérer tout en permettant aux ingénieurs d'utiliser plus efficacement les fonctionnalités du langage Go.
Le guide a été initialement rédigé par Prashant Varanasi et Simon Newton dans le but de permettre à leurs collègues d'utiliser rapidement Go. Au fil des ans, le guide a été modifié en fonction des retours d'autres personnes.
Ce document enregistre les conventions idiomatiques dans le code Go que nous suivons chez Uber. Beaucoup d'entre elles sont des lignes directrices générales pour Go, tandis que d'autres lignes directrices étendues dépendent des guides externes suivants:
Notre objectif est de rendre les exemples de code adaptés à l'utilisation avec deux versions de Go releases.
Tout le code doit passer les vérifications de golint et go vet sans erreurs. Nous recommandons de configurer votre éditeur pour:
- Exécuter
goimportsà chaque sauvegarde - Exécuter
golintetgo vetpour la vérification des erreurs
Dépôt GitHub : https://github.com/uber-go/guide
Dépôt GitHub : https://github.com/xxjwxc/uber_go_guide_cn