Uber ist ein Technologieunternehmen mit Sitz im Silicon Valley, USA, und ein früher Anwender der Go-Sprache. Es hat viele golang-Projekte als Open Source veröffentlicht, wie zum Beispiel die bekannten Projekte "Zap" und "Jaeger" in der Gopher-Community. Ende 2018 stellte Uber seinen internen Go-Style-Guide auf GitHub als Open Source zur Verfügung. Nach einem Jahr der Anhäufung und Aktualisierungen hat der Guide Form angenommen und weitreichende Aufmerksamkeit von Gophers erhalten. Dieser Artikel ist die chinesische Version des Leitfadens.

Der Code-Stil regelt die Konventionen, die unseren Code steuern. Diese Konventionen umfassen nicht nur das von gofmt behandelte Quelldateiformat für uns.

Das Ziel dieses Leitfadens ist es, diese Komplexität zu verwalten, indem im Detail die Überlegungen zum Schreiben von Go-Code bei Uber beschrieben werden. Die Existenz dieser Regeln soll das Code-Repository leicht zu verwalten machen und den Ingenieuren gleichzeitig ermöglichen, die Funktionen der Go-Sprache effektiver zu nutzen.

Der Leitfaden wurde zunächst von Prashant Varanasi and Simon Newton verfasst, mit dem Ziel, Kollegen zu ermöglichen, Go schnell einzusetzen. Im Laufe der Jahre wurde der Leitfaden auf Basis von Rückmeldungen anderer angepasst.

Dieses Dokument enthält die idiomatischen Konventionen im Go-Code, die wir bei Uber befolgen. Viele davon sind allgemeine Richtlinien für Go, während andere erweiterte Richtlinien von den folgenden externen Leitfäden abhängen:

  1. Effektives Go
  2. Häufige Fehler in Go
  3. Kommentare zur Code-Überprüfung in Go

Unser Ziel ist es, dass die Codebeispiele für die Verwendung mit zwei Go-Versionen veröffentlicht geeignet sind.

Alle Codes sollten die Prüfungen von golint und go vet ohne Fehler bestehen. Wir empfehlen, Ihren Editor so einzurichten, dass:

  • Bei Speichern goimports ausgeführt wird
  • Fehlerprüfung durch golint und go vet durchgeführt wird

GitHub-Repository: https://github.com/uber-go/guide

GitHub-Repository: https://github.com/xxjwxc/uber_go_guide_cn