Preparar y crear un commit

Este es el camino del trabajo hasta el registro: elegir qué entra, escribir el mensaje y hacer el commit.

Antes de empezar

• Un proyecto abierto, con repositorio Git.
• Ningún conflicto sin resolver. Con un conflicto abierto, el dock de commit queda bloqueado a propósito: registrar una resolución a medias es peor que no registrar nada.
• Para usar el botón que escribe el mensaje con el agente, un asistente configurado. Sin él, el botón simplemente no aparece.

1. Poner archivos en el commit

Cada línea de la sección Cambios tiene la acción de preparar o retirar:

• Poner en el commit — el cambio de ese archivo pasa a formar parte del próximo commit.
• Sacar del commit — deshace la preparación de ese archivo, sin tocar su contenido.

Hay dos atajos para trabajar en volumen:

1. Elegir varios archivos — entra en un modo de selección; con la selección hecha, las acciones valen para el conjunto, y el panel informa cuántos archivos están elegidos.
2. Poner todo en el commit — actúa sobre el grupo entero de una vez (el mismo menú tiene la versión por grupo y la versión para todos los archivos elegibles).

Lo que no se prepara en lote: líneas en conflicto sin resolver. Preparar un archivo en conflicto sin haber mirado la resolución borra el registro del conflicto antes de que lo revises — el panel deja esa decisión para el gesto individual.

2. Escribir el mensaje

El dock, en el pie del panel, es donde vive el mensaje. Queda anclado allí a propósito: en el modelo antiguo la caja de commit subía y bajaba según el número de archivos cambiados, y el mismo gesto cambiaba de lugar.

Dos formas de escribir:

• Teclear el mensaje en el campo.
• Escribir el mensaje con el agente — el botón dentro del campo le pide a un asistente un resumen de los cambios. Mientras trabaja, el panel dice que el agente está escribiendo y ofrece detenerlo. Si no hay cambios que resumir, el panel avisa en lugar de devolver un mensaje vacío.

Ctrl+Enter (o ⌘+Enter) hace el commit sin quitar las manos del teclado.

3. Hacer el commit

El botón Commit tiene un comportamiento que vale la pena conocer: con nada preparado, prepara todos los cambios elegibles y hace el commit — el nombre promete el commit, no dos clics. El texto del propio botón cambia para decir cuál de los dos casos es el tuyo: «Hacer commit de lo que está en el commit» o «Pone todos los cambios en el commit y hace commit».

Después del éxito, el borrador del mensaje se limpia. Después de un fallo, no se limpia: no pierdes lo que escribiste.

Resultado

• El commit existe en el repositorio del proyecto y aparece en la sección Commits.
• El árbol queda limpio: los archivos que entraron salen de la lista de cambios.
• El encabezado actualiza el recuento de commits no publicados.

Limpieza y cuidado

• El mensaje vacío se rechaza. «Escribe un mensaje para hacer el commit» es la respuesta del panel.
• Sin nada que commitear, el panel avisa; no crea un commit vacío.
• Prepara con cuidado el caso de «poner todo». Preparar automáticamente puede incluir archivos que no querías en ese commit — build, log, borrador. Cuando el commit tenga un solo asunto, prepara por archivo o por grupo.
• Commit no es publicación. Nada sale de tu máquina hasta que publiques la rama.
• Deshacer un commit no tiene botón en el panel. Si hiciste el commit equivocado, el camino es por la terminal del proyecto, con el cuidado que la operación exige — y, con usuarios reales trabajando en el repositorio, prefiere un commit nuevo que corrija antes que reescribir historia ya publicada.

Próximos pasos

• Historial de commits