---
id: "fluxos.git-preparar-e-commitar"
titulo: "Preparar y crear un commit"
resumo: "Elige qué entra en el próximo commit, escribe el mensaje y registra el cambio en el repositorio del proyecto."
idioma: "es"
tipo: "tutorial"
categoria: "arquivos-git"
aplicavelDesde: "0.0.16"
capabilities: ["git.changes.stage", "git.commit.create"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/es/fluxos/git-preparar-e-commitar/"
fonte: "pt-br/fluxos/git-preparar-e-commitar.md"
caminhoPublico: "docs/publica/es/fluxos/git-preparar-e-commitar.md"
hashFonte: "sha256:0718e77718bb1b87dd0297c97b5daf0d303e054c52b5f901547096171ac5c0a5"
hashDestaPagina: "sha256:d32031fd37ec6ad20b26b426696ac02e3a760f01df48d79cf882db3799c84879"
traducaoAssistidaPorIA: true
traducaoDesatualizada: false
corpoRetido: false
---
<!-- traducao-assistida-por-ia: idioma=ES fonte=pt-br/fluxos/git-preparar-e-commitar.md fonteHash=sha256:0718e77718bb1b87dd0297c97b5daf0d303e054c52b5f901547096171ac5c0a5 estado=atual -->

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](/docs/es/fluxos/git-historico/)