Almacenamiento del trabajo con confirmaciones

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Git no toma automáticamente instantáneas del trabajo mientras modifica archivos en el repositorio. Debe indicar a Git qué cambios de archivo quiere capturar en una instantánea mediante el almacenamiento provisional de cambios específicos. Después del almacenamiento provisional, realice una confirmación para guardar la instantánea.

En este artículo se proporcionan procedimientos para las tareas siguientes:

• Seguimiento de los cambios en Git
• Qué hay en una confirmación
• Procedimiento para almacenar provisionalmente los cambios
• Procedimiento para crear una confirmación
• Procedimiento para actualizar la última confirmación

Para obtener información general sobre el flujo de trabajo de Git, vea Tutorial de Git de Azure Repos.

Seguimiento de los cambios en Git

A medida que trabaja en el repositorio, Git realiza el seguimiento de los cambios en todos los archivos de los que se ha realizado el seguimiento. Los archivos de los que se ha realizado el seguimiento son archivos almacenados provisionalmente o que se incluyen en la confirmación anterior. Git separa los archivos de los que se ha realizado el seguimiento en tres categorías:

• Archivos sin modificar: los archivos que no han cambiado desde la última confirmación.
• Archivos modificados: los archivos que han cambiado desde la última confirmación, pero que no se han almacenado provisionalmente para la siguiente.
• Archivos almacenados provisionalmente: los archivos que han cambiado desde la última confirmación y que se han almacenado provisionalmente para la siguiente.

Cuando se crea una confirmación, para la instantánea solo se usan archivos almacenados provisionalmente y archivos sin modificar. Los cambios sin almacenar provisionalmente en los archivos modificados se conservan, pero la instantánea contiene la versión sin modificar de esos archivos. Git no realiza el seguimiento de los cambios en los nuevos archivos ni incluye nuevos archivos en la instantánea hasta que los almacene provisionalmente.

Las confirmaciones se crean en el repositorio de Git local. Cada confirmación no tiene que ser perfecta y es posible que se necesiten varias confirmaciones para lograr un cambio previsto. Cree confirmaciones mientras trabaja y, cuando haya terminado, puede insertarlas en un repositorio remoto para compartir el trabajo con otros usuarios.

Qué hay en una confirmación

Cada confirmación incluye la información siguiente:

• Una instantánea de todos los archivos de los que se ha realizado el seguimiento en el repositorio en el momento de la confirmación. Una instantánea no es la diferencia entre confirmaciones, aunque Git usa instantáneas para calcular la diferencia. Las instantáneas permiten el cambio rápido entre ramas y admiten la combinación de ramas.
• Una referencia a la confirmación principal. La mayoría de las confirmaciones tienen un elemento principal, pero la siguiente confirmación después de una combinación de ramas tiene varios elementos principales y la primera confirmación de un repositorio no tiene ninguno.
• Un mensaje que describe los cambios en la confirmación. Debe escribir el mensaje al crear la confirmación.

Git usa la instantánea y las referencias principales de cada confirmación para mantener un registro completo del desarrollo en el repositorio. Para investigar los cambios en el código, puede revisar el historial de Git del repositorio.

Procedimiento para almacenar provisionalmente los cambios

A fin de crear una instantánea para una confirmación:

• Almacene provisionalmente los archivos nuevos para informar a Git que quiere que se agreguen a la instantánea y que Git realice el seguimiento de los cambios en esos archivos en el futuro.
• Almacene provisionalmente los archivos editados para que Git sepa que quiere la versión del archivo modificado en la instantánea, no la versión del archivo sin modificar.
• Almacene provisionalmente los archivos eliminados para que Git sepa que quiere quitarlos de la instantánea y que no se realice su seguimiento.

Para excluir archivos temporales, archivos de registro u otros archivos de la instantánea, puede configurar Git para omitir archivos específicos.

Nota:

Git admite el almacenamiento provisional interactivo de archivos editados para que pueda elegir almacenar provisionalmente cambios específicos en un archivo. Se trata de una característica útil cuando se quieren modificaciones de archivo diferentes en diferentes confirmaciones.

Visual Studio 2022

Visual Studio 2022 proporciona una experiencia de control de versiones de Git mediante el menú Git, Cambios de Git y los menús contextuales del Explorador de soluciones. En Visual Studio 2019, versión 16.8, también se ofrece la interfaz de usuario de Git Team Explorer. Parar más información, vea la pestaña Visual Studio 2019: Team Explorer.

En la ventana Cambios de Git, haga clic con el botón derecho en un archivo de la sección Cambios y elija Agregar al "stage" para agregarlo a la sección Cambios "staged".

O bien, puede agregar al "stage" un archivo cambiado si selecciona el signo más situado junto al archivo. Para almacenar provisionalmente todos los archivos modificados en una carpeta, seleccione el signo más situado junto a la carpeta. Para almacenar provisionalmente todos los archivos modificados en el repositorio, seleccione el signo más de la esquina superior derecha de la sección Cambios.

Puede indicar a Git que omita un archivo si hace clic con el botón derecho en él y selecciona Omitir este elemento local u Omitir esta extensión. Cualquiera de los comandos crea un archivo .gitignore en el repositorio si no existe y le agrega una entrada. Los archivos omitidos no aparecerán en la sección Cambios de Visual Studio. Pero el archivo .gitignore no tiene ningún efecto en los archivos de seguimiento. Para obtener información sobre cómo configurar Git para omitir los archivos con seguimiento, vea Omitir archivos. Para ahorrar tiempo, puede descargar plantillas de .gitignore para varios entornos de desarrollo desde el repositorio gitignore de GitHub.

Nota:

A partir de la versión 17.3 de Visual Studio 2022, en Visual Studio se admite el almacenamiento provisional de cambios parciales en un archivo. Para más información, vea Almacenamiento provisional de líneas de código en Visual Studio.

Visual Studio 2019: menú Git

Visual Studio 2019 proporciona una experiencia de control de versiones de Git mediante el menú Git, Cambios de Git y los menús contextuales del Explorador de soluciones.

En la ventana Cambios de Git, haga clic con el botón derecho en un archivo de la sección Cambios y elija Agregar al "stage" para agregarlo a la sección Cambios "staged".

O bien, puede agregar al "stage" un archivo cambiado si selecciona el signo más situado junto al archivo. Para almacenar provisionalmente todos los archivos modificados en una carpeta, seleccione el signo más situado junto a la carpeta. Para almacenar provisionalmente todos los archivos modificados en el repositorio, seleccione el signo más de la esquina superior derecha de la sección Cambios.

Puede indicar a Git que omita un archivo si hace clic con el botón derecho en él y selecciona Omitir este elemento local u Omitir esta extensión. Cualquiera de los comandos crea un archivo .gitignore en el repositorio si no existe y le agrega una entrada. Los archivos omitidos no aparecerán en la sección Cambios de Visual Studio. Pero el archivo .gitignore no tiene ningún efecto en los archivos de seguimiento. Para obtener información sobre cómo configurar Git para omitir los archivos con seguimiento, vea Omitir archivos. Para ahorrar tiempo, puede descargar plantillas de .gitignore para varios entornos de desarrollo desde el repositorio gitignore de GitHub.

Visual Studio 2019: Team Explorer

Visual Studio 2019, versión 16.8 y versiones posteriores, proporciona una experiencia de control de versiones de Git al tiempo que mantiene la interfaz de usuario de Git de Team Explorer. Para usar Team Explorer, desactive Herramientas>Opciones>Características en versión preliminar>Nueva experiencia de usuario de Git en la barra de menús. Puede usar las características de Git indistintamente desde cualquier interfaz.

1. En Team Explorer, seleccione el botón Inicio y elija Cambios.

   

2. En la vista Cambios, haga clic con el botón derecho en un archivo de la sección Cambios y elija Agregar al "stage" para agregarlo a la sección Cambios "staged".

   

   O bien, puede agregar al "stage" un archivo modificado si arrastra desde la sección Cambios hasta la sección Cambios staged. Para agregar al "stage" todos los archivos modificados en una carpeta, haga clic con el botón derecho en la carpeta y elija Agregar al "stage". Para almacenar provisionalmente todos los archivos modificados en el repositorio, seleccione el signo más de la esquina superior derecha de la sección Cambios.

Puede indicar a Git que omita un archivo si hace clic con el botón derecho en él y selecciona Omitir este elemento local u Omitir esta extensión. Cualquiera de los comandos crea un archivo .gitignore en el repositorio si no existe y le agrega una entrada. Los archivos omitidos no aparecerán en la sección Cambios de Visual Studio. Pero el archivo .gitignore no tiene ningún efecto en los archivos de seguimiento. Para obtener información sobre cómo configurar Git para omitir los archivos con seguimiento, vea Omitir archivos. Para ahorrar tiempo, puede descargar plantillas de .gitignore para varios entornos de desarrollo desde el repositorio gitignore de GitHub.

Nota:

Visual Studio 2019 no admite el almacenamiento provisional de cambios parciales en un archivo.

Línea de comandos de Git

Para almacenar provisionalmente todos los archivos de los que se ha realizado el seguimiento y sin seguimiento en el repositorio que hayan cambiado desde la última confirmación, use el comando git add con la marca --all. Pero la marca --all no almacenará provisionalmente los archivos que haya configurado para que Git los omita.

git add --all

Puede almacenar provisionalmente los cambios en archivos específicos con el siguiente comando.

git add <file path>

Puede almacenar provisionalmente de forma interactiva partes de un archivo modificado de forma interactiva mediante la opción --patch.

git add --patch <file path>

Otros comandos de Git relacionados son los siguientes:

• git rm para eliminar archivos en el repositorio y almacenar provisionalmente el cambio.
• git mv para mover o cambiar de nombre archivos en el repositorio y almacenar provisionalmente el cambio.
• git status para revisar el estado actual de los cambios en el repositorio.

Para más información sobre estos comandos, v vea la referencia de comandos del tutorial y la referencia de la línea de comandos de Git.

Sugerencia

Después de almacenar provisionalmente los archivos, revise los cambios almacenados provisionalmente y sin almacenar provisionalmente mediante la ejecución de git status.

Procedimiento para crear una confirmación

Visual Studio 2022

En la ventana Cambios de Git, escriba un mensaje que describa los cambios almacenados provisionalmente y, después, seleccione Confirmar elementos almacenados provisionalmente.

Seleccione el vínculo de confirmación para obtener los detalles de la confirmación.

Nota:

Si todos los cambios no están almacenados provisionalmente, puede omitir el almacenamiento provisional y confirmar directamente si elige Confirmar todo.

Visual Studio 2019: menú Git

En la ventana Cambios de Git, escriba un mensaje que describa los cambios almacenados provisionalmente y, después, seleccione Confirmar elementos almacenados provisionalmente.

Seleccione el vínculo de confirmación para obtener los detalles de la confirmación.

Nota:

Si todos los cambios no están almacenados provisionalmente, puede omitir el almacenamiento provisional y confirmar directamente si elige Confirmar todo.

Visual Studio 2019: Team Explorer

1. En la vista Cambios de Team Explorer, escriba un mensaje que describa los cambios almacenados provisionalmente y, después, seleccione Confirmar elementos almacenados provisionalmente.

   

2. Seleccione el vínculo de confirmación para obtener los detalles de la confirmación.

   

   Nota:

   Si todos los cambios no están almacenados provisionalmente, puede omitir el almacenamiento provisional y confirmar directamente si elige Confirmar todo.

   

Línea de comandos de Git

Puede crear una confirmación mediante el comando git commit con la marca -m para especificar un mensaje de confirmación. Si no proporciona un mensaje de confirmación, Git abrirá un editor para que pueda proporcionar uno.

git commit -m "<commit message>"

Sugerencia

Antes de realizar una confirmación, revise los cambios almacenados provisionalmente y sin almacenar provisionalmente mediante la ejecución de git status.

Procedimiento para actualizar la última confirmación

Git admite el cambio de los archivos almacenados provisionalmente o del mensaje de la última confirmación. Esta operación reemplaza la última confirmación por una nueva en la que se combinan los archivos almacenados provisionalmente de las dos confirmaciones y usa el nuevo mensaje de confirmación. La rectificación de una confirmación es útil si ha olvidado almacenar provisionalmente un archivo o el último mensaje de confirmación tiene un error tipográfico.

Advertencia

No rectifique una confirmación ya insertada porque provocará problemas de sincronización con el repositorio remoto. Para una confirmación insertada, use una de estas estrategias:

• Cree e inserte otra confirmación que corrija los problemas causados por la confirmación anterior.
• Deshaga la confirmación anterior que se ha insertado; para ello, use git revert para crear una confirmación que revierta todos los cambios realizados por la confirmación anterior. Después, inserte la nueva confirmación.

Visual Studio 2022

En la ventana Cambios de Git, como opción, almacene provisionalmente uno o varios archivos, escriba un mensaje de confirmación, seleccione Rectificar y, después, elija Confirmar elementos almacenados provisionalmente.

En la ventana Cambios de Git se admite la rectificación del mensaje de confirmación, de los archivos almacenados provisionalmente o ambas cosas. Al seleccionar Rectificar, se muestra el identificador SHA de la confirmación anterior.

Visual Studio 2019: menú Git

En la ventana Cambios de Git, como opción, almacene provisionalmente uno o varios archivos, escriba un mensaje de confirmación, seleccione Rectificar y, después, elija Confirmar elementos almacenados provisionalmente.

En la ventana Cambios de Git se admite la rectificación del mensaje de confirmación, de los archivos almacenados provisionalmente o ambas cosas. Al seleccionar Rectificar, se muestra el identificador SHA de la confirmación anterior.

Visual Studio 2019: Team Explorer

En la vista Cambios de Team Explorer, almacene provisionalmente uno o varios archivos, escriba un mensaje de confirmación y, después, elija Acciones > Rectificar confirmación anterior.

Team Explorer no admite la rectificación del mensaje de confirmación sin rectificar también uno o varios archivos almacenados provisionalmente.

Línea de comandos de Git

1. Almacene provisionalmente los cambios nuevos, si los hubiera.

2. Use el comando git commit con la opción --amend y la marca -m para especificar el nuevo mensaje de confirmación.

git commit --amend -m "<new message>"

Pasos siguientes

Creación del trabajo en ramas

Artículos relacionados

• ¿No está familiarizado con los repositorios de Git? Más información