Uber es una empresa tecnológica con sede en Silicon Valley, EE. UU., y una de las primeras en adoptar el lenguaje Go. Ha compartido muchos proyectos de Go en código abierto, como el conocido zap y jaeger en la comunidad Gopher. A finales de 2018, Uber hizo público su guía de estilo interna de Go en GitHub. Tras un año de acumulación y actualizaciones, la guía ha tomado forma y ha recibido una amplia atención por parte de los Gophers. Este artículo es la versión en chino de la guía.

El estilo de código gobierna las convenciones que controlan nuestro código. Estas convenciones abarcan no solo el formato de archivo fuente manejado por gofmt para nosotros.

El propósito de esta guía es gestionar esta complejidad describiendo en detalle las consideraciones para escribir código Go en Uber. La existencia de estas reglas es para hacer que la base de código sea fácil de gestionar, al mismo tiempo que permite a los ingenieros utilizar de manera más efectiva las características del lenguaje Go.

La guía fue escrita inicialmente por Prashant Varanasi y Simon Newton con el objetivo de permitir a los colegas utilizar rápidamente Go. A lo largo de los años, la guía ha sido modificada basándose en los comentarios de otros.

Este documento registra las convenciones idiomáticas en el código Go que seguimos en Uber. Muchas de ellas son pautas generales para Go, mientras que otras pautas extendidas dependen de las siguientes guías externas:

  1. Effective Go
  2. Errores comunes de Go
  3. Comentarios de revisión de código de Go

Nuestro objetivo es hacer que los ejemplos de código sean adecuados para su uso con dos versiones releases de Go.

Todo el código debe pasar las comprobaciones de golint y go vet sin errores. Recomendamos configurar su editor para:

  • Ejecutar goimports al guardar
  • Ejecutar golint y go vet para la comprobación de errores

Repositorio en GitHub: https://github.com/uber-go/guide

Repositorio en GitHub: https://github.com/xxjwxc/uber_go_guide_cn