Melhores práticas do Git

Mejores prácticas de Git

Cómo trabajar y colaborar eficazmente con el sistema de control de versiones más popular del planeta.

Imagem em destaque

Git es, en general, el sistema de control de versiones más utilizado del planeta. Con esta herramienta, los desarrolladores pueden colaborar y trabajar mucho más fácilmente. Git simplifica el seguimiento de los cambios en el código e implementa velocidad, integridad de datos y soporte para flujos de trabajo distribuidos y no lineales.

En resumen, git toma lo que de otro modo podría ser un caos en la vida de un desarrollador y lo estructura de tal manera que un proyecto pueda gestionarse más fácilmente y entregarse de manera más efectiva.

Si usted y su equipo recién están comenzando a usar git, se llevarán una sorpresa. Y si has estado usando git por un tiempo, es posible que hayas trabajado con un equipo que no aprovecha al máximo esta herramienta. No importa dónde se encuentre en su recorrido por Git, existen mejores prácticas que debe aplicar en cada paso del camino. Si sigue este consejo, su experiencia con Git no solo mejorará enormemente, sino que la colaboración será más fluida y eficiente.

Echemos un vistazo a algunas de estas mejores prácticas. Se aplicarán independientemente del idioma que uses con Git. Entonces, ya sea que sea un desarrollador de Java, JavaScript, .NET, C++, Ruby, Python o PHP, o que trabaje solo o en un equipo de nivel empresarial, se aplicarán estas mejores prácticas.

Compromisos de un solo propósito

Una confirmación es una operación que confirma los últimos cambios de código realizados en el repositorio de origen. Un compromiso puede ser cualquier cosa. Digamos que encontró un error tipográfico en su código. Corrige el error tipográfico y crea una confirmación. Las confirmaciones facilitan que su equipo sepa lo que ha hecho con la última versión del código.

Uno de los inconvenientes de usarlos es retenerlos hasta que haya realizado una serie de cambios y luego impulsar una confirmación que cubra todos esos cambios. Cuando haces esto, la revisión del código se vuelve menos eficiente. En su lugar, genere una confirmación para un único propósito, que:

  • Hace que la revisión del código sea más eficiente.
  • Facilita la reversión del código a un estado anterior.
  • Realiza un seguimiento de los cambios en un sistema de tickets.
  • Hace que git log sea más fácil de ver.

Escribir mensajes de confirmación informativos

Una característica muy importante de las confirmaciones es agregarles mensajes. Estos mensajes son informativos, por lo que su equipo tiene una idea clara de lo que hizo en la confirmación. Si simplemente agrega un mensaje de confirmación genérico o sin sentido, no le hará ningún favor al equipo.

Al crear una confirmación, asegúrese de agregar un mensaje informativo que indique claramente el trabajo que ha realizado. Sea conciso, pero también proporcione suficiente información para que lo que hizo sea obvio para todos los involucrados.

Una confirmación útil podría verse así:

 característica: característica agregada X

 ^--^ ^---------------^

 +-> Resumen de una característica recién agregada.

 +-------> Tipo de característica agregada con la confirmación.

También debes ser coherente con tus compromisos. Su equipo debe desarrollar un estilo que haga que sea muy fácil escribir estos comentarios, así como comprender rápidamente lo que se incluyó en la confirmación.

Comprométete temprano y con frecuencia

Esto va junto con las confirmaciones de propósito único. Debe comenzar a agregar sus confirmaciones desde el principio y a intervalos regulares (probablemente cada vez que realice un cambio en el código del repositorio). No pierda el hábito de comprometerse; de ​​lo contrario, terminará sin seguir las mejores prácticas de compromiso con un solo propósito, confundiendo así a su equipo o haciéndolos trabajar más duro de lo necesario.

Aplastar múltiples confirmaciones

En algún momento, encontrará demasiadas confirmaciones con un solo propósito, lo que dificultará la búsqueda en el repositorio de git. Piénselo de esta manera: si tiene 100 confirmaciones para cada rama de función que cree, eso puede sumar un total enorme. Entonces, en lugar de dejar todas estas confirmaciones únicas como están, elimínelas con el comando git rebase . Esto abrirá un editor que enumera las confirmaciones y le permite actuar en consecuencia.

El objetivo es mantener su repositorio lo más informativo y limpio posible.

Nunca cambies la historia

Una vez que presionas un compromiso, nunca debes cambiarlo en el historial de tu proyecto. Cuando hace esto, resulta casi imposible mantener un control consistente del control de versiones. Entonces, incluso si tienes la tentación de usar git rebase para aplastar las confirmaciones, solo debes hacer esto en las ramas que no estés usando.

La rama con la que está trabajando siempre debe permanecer intacta con su historial completo (y confirmaciones). Esto es así incluso si cometiste un gran error en una confirmación. Corrija este error y cree otra confirmación para que todos sepan que el problema está resuelto.

Usar etiquetas

Una etiqueta es una instantánea del estado de una sucursal en un momento determinado. Piense en una etiqueta como un puntero con nombre a una confirmación específica. Esto es muy útil cuando desea especificar un punto en el historial de un proyecto como importante. Por ejemplo, es posible que desee marcar puntos de versión como v1.0, v1.2 o v2.0. Las etiquetas hacen que esto sea fácil.

Git permite crear etiquetas ligeras o anotadas. Una etiqueta liviana es como una rama que no cambia, mientras que las etiquetas anotadas se almacenan como objetos completos en la base de datos de Git. Las etiquetas anotadas también pueden contener una suma de verificación, el nombre del etiquetador, una dirección de correo electrónico, la fecha, un mensaje de etiquetado y se pueden firmar y verificar con GNU Privacy Guard (GPG).

La etiqueta más utilizada es la etiqueta anotada.

Conclusión

Git es una herramienta que todo desarrollador de software debería utilizar para el control de versiones. Y cuando adopta Git, es importante configurar y seguir las mejores prácticas para asegurarse de que su experiencia sea simple y eficiente.

Fuente: BairesDev

Regresar al blog

Deja un comentario

Ten en cuenta que los comentarios deben aprobarse antes de que se publiquen.