Omitir los cambios de archivo con Git

Azure Repos | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2015

Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015

No todos los archivos que se crean o actualizan en el código se deben confirmar en Git. Los archivos temporales del entorno de desarrollo, las salidas de prueba y los registros son ejemplos de archivos que se crean pero que no forman parte del código base. Personalice los archivos de los que Git realiza un seguimiento a través de la característica gitignore.

En este tutorial, aprenderá a:

Uso de gitignore para evitar el seguimiento de archivos

Cree un archivo .gitignore en el repositorio de Git para evitar que Git almacenamiento provisional de archivos no deseados. Comparta .gitignore en la rama predeterminada del repositorio. Usted y su equipo pueden actualizar el archivo para cambiar los tipos de archivos que se omitirán.

Creación de un archivo .gitignore

fsutil file createnew C:\Users\frank\myrepo\.gitignore 0

touch /home/frank/myrepo/.gitignore

Git aplica .gitignore a la carpeta y a las carpetas secundarias donde se encuentra. Se recomienda colocar el archivo .gitignore en la carpeta raíz del repositorio para evitar confusiones.

Personalización del archivo .gitignore

Modifique el archivo .gitignore para incluir tipos de archivos, rutas de acceso y patrones de archivo en el repositorio. Git empieza a omitir estos archivos en cuanto actualiza .gitignore. Si otros usuarios del equipo necesitan el mismo conjunto de archivos omitido, asegúrese de confirmar los cambios.

vim /home/frank/myrepo/.gitignore

Cada línea del archivo .gitignore excluye un archivo o conjunto de archivos que coinciden con un patrón. La sintaxis de gitignore completa es muy flexible. Estos son algunos ejemplos de las entradas más comunes:

# ignore a single file
mycode.class

# ignore an entire directory
/mydebugdir/

# ignore a file type
*.json

# add an exception (using !) to the preceding rule to track a specific file
!package.json

Omitir archivos solo en el sistema

El archivo .gitignore se comparte entre los miembros del equipo como un archivo confirmado y se inserta en el repositorio de Git. Para excluir archivos solo en el sistema, edite el archivo .git/info/exclude en el repositorio local. Los cambios en este archivo no se comparten con otros usuarios. Solo se aplican a los archivos de ese repositorio. La sintaxis de este archivo es la misma que la que se usa en .gitignore.

Omitir archivos en todos los repositorios del sistema

Configure un archivo .gitignore global para usarlo en todos los repositorios del sistema mediante la herramienta de línea de comandos, como en el ejemplo siguiente:

git config core.excludesfile C:\Users\frank\.gitignore_global

Este enfoque es útil para omitir tipos de archivo completos que no desea confirmar nunca, como los archivos binarios compilados.

Omitir los cambios en los archivos confirmados

Omitir temporalmente los cambios

Durante el desarrollo, es conveniente detener el seguimiento de los cambios de archivos en un archivo confirmado en el repositorio de Git. Este enfoque es útil al personalizar la configuración o los archivos de configuración que forman parte del origen del proyecto para su propio entorno de trabajo.

git update-index --skip-worktree <file>

Reanude los archivos de seguimiento con el siguiente comando:

git update-index --no-skip-worktree <file>

En su lugar, puede usar los parámetros siguientes. Estos parámetros son principalmente para marcar archivos que los desarrolladores no deben cambiar.

Para deshabilitar el seguimiento de cambios:

git update-index --assume-unchanged <file>

Para reanudar el seguimiento de cambios:

git update-index --no-assume-unchanged <file>

Detener permanentemente el seguimiento de un archivo

Si Git ya realiza el seguimiento de un archivo, .gitignore no se aplica. Git seguirá haciendo un seguimiento de los cambios en ese archivo.

Si desea detener el seguimiento de un archivo, debe decir explícitamente a Git que quiere que se quite del seguimiento. Siguiendo estas instrucciones, el archivo permanecerá en el directorio de trabajo local, pero ya no se realizará el seguimiento en Git.

1. Agregue el archivo en .gitignore .

2. Ejecute el siguiente comando:

   git rm --cached  <file>
   

3. Confirme la eliminación del archivo y del archivo .gitignore actualizado en el repositorio.

Pasos siguientes