Preferencias y configuración de Git en Visual Studio

Servicios de Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2019 | Visual Studio 2022

En Visual Studio, puede ver y configurar varias opciones y preferencias relacionadas con Git. Por ejemplo, puede establecer el nombre y la dirección de correo electrónico para los metadatos de confirmación, especificar las herramientas de combinación y diferencias preferidas, y establecer la ruta de carpetas predeterminada para clones de repositorios.

La configuración y las preferencias de Git en Visual Studio se dividen en dos categorías principales:

  • Configuración global de Git, que se aplica a todos los repositorios de Git para el usuario actual.

  • Configuración del repositorio de Git, que se aplica al repositorio de Git activo.

Dentro de esas categorías, la configuración puede ser:

  • Opciones de archivo de configuración de Git, que puede ver y modificar en Visual Studio, en la línea de comandos o editando un archivo de configuración de Git. Algunos ejemplos de opciones de archivo de configuración de Git son el nombre de usuario, la dirección de correo electrónico y los alias remotos. Git almacena la configuración en los archivos de configuración del sistema, global y local de Git:

    • Los valores de archivo de configuración de Git del sistema se aplican a todos los usuarios y repositorios del equipo.

    • La configuración global del archivo de configuración de Git se aplica a todos los repositorios del usuario actual. La configuración global tiene prioridad sobre la configuración del sistema.

    • Las opciones del archivo de configuración de Git local se aplican al repositorio local que contiene el archivo de configuración de Git local. La configuración local tiene prioridad sobre la configuración global.

  • Configuración relacionada con Git de Visual Studio, que son configuraciones de Visual Studio relacionadas con Git, pero que no se almacenan en ningún archivo de configuración de Git. Solo puede ver y modificar esta configuración en Visual Studio. Un ejemplo de este tipo de valores es la ruta de acceso de carpeta predeterminada donde Visual Studio clona los repositorios.

En este artículo aprenderá a:

  • Exploración de la configuración de Git
  • Modificación de la configuración del archivo de configuración de Git
  • Modificación de la configuración relacionada con Git de Visual Studio

Prerrequisitos

Categoría Requisitos
Acceso al proyecto Miembro de un proyecto .
Permisos - Ver código en proyectos privados: al menos acceso básico.
- Clonar el código o contribuir en él en proyectos privados: miembro del grupo de seguridad de contribuyentes o los permisos correspondientes en el proyecto.
- Establecer permisos de rama o repositorio: Administrar permisos son permisos para la rama o el repositorio.
- Cambiar rama predeterminada: las directivas de edición son permisos para el repositorio.
- Importar un repositorio: miembro del grupo de seguridad de Administradores de proyecto o repositorio Git a nivel de proyecto Crear repositorio con la opción Permitir. Para obtener más información, consulte Establecimiento de permisos de repositorios Git.
Servicios Repositorio habilitado.
Herramientas Opcional. Uso de az repos comandos: CLI de Azure DevOps.

Nota:

En proyectos públicos, los usuarios con acceso a las partes interesadas tienen acceso completo a Azure Repos, incluida la visualización, la clonación y la contribución al código.

Categoría Requisitos
Acceso al proyecto Miembro de un proyecto .
Permisos - Ver código: al menos acceso básico.
- Clonar o contribuir al código: Miembro de la Colaboradores grupo de seguridad o los permisos correspondientes en el proyecto.
Servicios Repositorio habilitado.

Exploración de la configuración de Git

Visual Studio 2022 proporciona una experiencia de control de versiones de Git mediante el menú Git , Cambios de Git y a través de menús contextuales en el Explorador de soluciones. La versión 16.8 de Visual Studio 2019 también ofrece la interfaz de usuario de Git de Team Explorer . Para obtener más información, consulte la pestaña Visual Studio 2019 - Team Explorer .

  1. Para configurar las opciones de Git en Visual Studio, elija Configuración de Git > en la barra de menús para abrir la vista Opciones.

    Captura de pantalla de la opción Configuración en la barra de menús de Visual Studio.

  2. En la vista Opciones , elija Configuración global de Git para ver la configuración que se aplica a todos los repositorios.

    Captura de pantalla de La configuración global de Git en el cuadro de diálogo Opciones de Visual Studio.

    O bien, en la vista Opciones , elija Configuración > general del repositorio de Git para ver la configuración que solo se aplica al repositorio de proyectos de Visual Studio actual.

    Captura de pantalla de la configuración del repositorio de Git en el cuadro de diálogo Opciones de Visual Studio.

Modificación de la configuración del archivo de configuración de Git

Puede ver y editar las opciones de configuración de Git en Visual Studio o editando directamente el archivo de configuración de Git aplicable. Para obtener más información sobre la configuración del archivo de configuración de Git, consulte Personalización de Git y la documentación de git-config. En las secciones siguientes, se describe cómo puede editar cada una de las opciones de archivo de configuración de Git enumeradas:

Nombre y correo electrónico

Al confirmar los cambios, Git agrega el nombre y la dirección de correo electrónico a los metadatos de confirmación. Puede editar el nombre y la dirección de correo electrónico que usará Git.

La configuración de nombre y correo electrónico está disponible en el ámbito global o del repositorio.

En el menú Git, elija Configuración de Git > y, a continuación, seleccione la vista Configuración global de Git. Esa vista contiene la configuración de nombre y correo electrónico del usuario actual.

Captura de pantalla de la configuración de nombre y correo electrónico en Configuración global de Git en el cuadro de diálogo Opciones de Visual Studio.

O bien, elija Configuración > general del repositorio de Git para editar la configuración de nombre y correo electrónico del repositorio de proyectos de Visual Studio actual.

Eliminación de ramas remotas durante la captura

Podrías decirle a Git que elimine las ramas remotas durante cada fetch para quitar las ramas de seguimiento remoto que se han quedado obsoletas en tu repositorio local y que ya no existen en el repositorio remoto correspondiente.

En el menú Git, elija Configuración de Git > y, a continuación, seleccione la vista Configuración global de Git. Esa vista contiene la opción Eliminar ramas remotas durante la captura para el usuario actual.

Captura de pantalla del valor Eliminar ramas remotas durante la captura en Configuración global de Git en el cuadro de diálogo Opciones de Visual Studio.

O bien, elija Configuración de repositorios de Git > General para editar el valor Eliminar ramas remotas durante la captura del repositorio de proyectos de Visual Studio actual.

Los valores válidos son:

  • True (recomendado)
  • False
  • Unset (valor predeterminado)

Fusión de la rama local mediante cambio de base al enviar cambios

Puede elegir fusionar mediante cambio de base la rama local durante la extracción para reproducir los cambios en la rama local sobre el historial de ramas remotas.

El valor Fusión de la rama local mediante cambio de base al enviar cambios se corresponde al comando git config pull.rebase. Puede especificar esta configuración en el ámbito global o del repositorio.

En el menú Git, elija Configuración de Git > y, a continuación, seleccione la vista Configuración global de Git. Esa vista contiene la opción Fusión de la rama local mediante cambio de base al enviar cambios para el usuario actual.

Captura de pantalla de la configuración de rebase en Configuración global de Git en el cuadro de diálogo Opciones de Visual Studio.

O bien, elija Configuración de repositorios de Git > General para editar la opción Fusión de la rama local mediante cambio de base al enviar cambios del repositorio de proyectos de Visual Studio actual.

Los valores válidos son:

  • True: fusione mediante cambio de base la rama actual en la parte superior de la rama remota después de la captura.
  • False: combine la rama remota en la rama actual.
  • Merges: fusione mediante cambio de base sin acoplar confirmaciones de combinación creadas localmente.
  • Unset (valor predeterminado): a menos que se especifique lo contrario en un archivo de configuración de Git, combine la rama remota en la rama actual.

Proveedor de red criptográfica

Puede especificar el proveedor de red criptográfica como el back-end TLS/SSL que Git usará en tiempo de ejecución.

La configuración del proveedor de red criptográfico corresponde al git config http.sslBackend comando . Esta configuración solo está disponible en el ámbito global.

En el menú Git, elija Configuración de Git > y, a continuación, seleccione la vista Configuración global de Git. Esa vista contiene la opción Proveedor de red criptográfico para el usuario actual.

Captura de pantalla de la configuración del proveedor de red criptográfico con OpenSSL seleccionado en Visual Studio.

Los valores válidos son:

  • OpenSSL: use OpenSSL para los protocolos TLS y SSL.
  • Secure Channel: use el canal seguro para los protocolos TLS y SSL. Canal seguro es la solución nativa de Windows que contiene un conjunto de protocolos de seguridad que proporcionan autenticación de identidad y comunicación privada segura a través del cifrado.
  • Unset (valor predeterminado): si esta configuración no está establecida, el proveedor de red criptográfico tiene como valor predeterminado OpenSSL.

Aplicación auxiliar de credenciales

Cuando Visual Studio realiza una operación de Git remota, el punto de conexión remoto podría rechazar la solicitud porque requiere credenciales para la solicitud. Cuando esto sucede, Git invoca un asistente de credenciales para obtener las credenciales necesarias y, a continuación, vuelve a intentar la solicitud. Puede especificar el asistente de credenciales que usará Git.

La configuración del asistente de credenciales corresponde al git config credential.helper comando . Esta configuración solo está disponible en el ámbito global.

  1. En el menú Git, elija Configuración de Git > y, a continuación, seleccione la vista Configuración global de Git para configurar esta configuración.

  2. Establezca El asistente de credenciales en el valor deseado y seleccione Aceptar para guardar.

    Captura de pantalla de la configuración del asistente de credenciales en el cuadro de diálogo Opciones de Visual Studio.

Los valores válidos son:

  • GCM for Windows: use el Administrador de credenciales de Git como asistente.
  • GCM Core: use Git Credential Manager Core como asistente.
  • Unset (valor predeterminado): si esta configuración no está establecida, se usa el asistente de credenciales establecido en la configuración del sistema. A partir de Git para Windows 2.29, el asistente de credenciales predeterminado es GCM Core.

Herramientas de comparación y fusión

Puede especificar qué herramientas usará Git para mostrar diferencias o conflictos de combinación.

Los valores de herramienta de diferencias y combinación se corresponden a los comandos git config diff.tool y git config merge.tool. Puede establecer Visual Studio como herramienta de combinación o diferencia, o bien configurar otras herramientas de diferencias y combinación desde la línea de comandos de Git. Puede especificar los valores de herramienta de diferencias y combinación en el ámbito global o del repositorio.

  1. En el menú Git, elija Configuración de Git > y, a continuación, seleccione la vista Configuración global de Git. Esa vista contiene los valores de herramientas de diferencias y combinación.

  2. Establezca la configuración de la herramienta de diferencias y mezcla en el valor deseado y seleccione Aceptar para guardar.

    Captura de pantalla que muestra la configuración de la herramienta de comparación y fusión en el cuadro de diálogo Opciones de Visual Studio.

    O bien, elija Configuración > general del repositorio de Git para editar la configuración de la herramienta de diferencias y combinación para el repositorio de proyectos de Visual Studio actual.

Las herramientas válidas para diferenciar y combinar son:

  • Visual Studio
  • None (valor predeterminado)

Para configurar otros valores de herramienta de diferencias y combinación, use la línea de comandos de Git.

Remotos

Puede usar el panel Remotos en Configuración del repositorio de Git para agregar, editar o quitar remotos para el repositorio. Esta configuración corresponde al git remote add comando . El panel Remotos solo está disponible en el ámbito del repositorio.

Al clonar un repositorio remoto, Git asigna el alias origin como abreviatura para la dirección URL del repositorio remoto que ha clonado. Para mayor comodidad, puede agregar otro alias denominado upstream para el repositorio del que se bifurcó, que se conoce como repositorio ascendente. En los pasos siguientes se describe cómo agregar un upstream alias.

Para agregar un upstream alias en Visual Studio, siga estos pasos:

  1. Elija Opciones de herramientas > en la barra de menús para abrir la ventana Opciones. Seleccione Configuración de control de código fuente del repositorio Git > Remotos > y, a continuación, elija Agregar para abrir el cuadro de diálogo Agregar remoto.

    Captura de pantalla del botón Agregar en el panel Remotos del submenú Configuración del repositorio de Git del menú Control de código fuente en Visual Studio.

  2. En el cuadro de diálogo Agregar remoto, agregue un nuevo remoto llamado upstream y escriba la dirección URL de clonación de Git del repositorio bifurcado. A continuación, elija Guardar.

    Captura de pantalla del cuadro de diálogo Agregar remoto en Visual Studio.

Otras opciones de configuración

Para ver todas las demás opciones de configuración de Git, puede abrir y ver los propios archivos de configuración de Git, o puede ejecutar git config --list para mostrar la configuración.


La siguiente configuración administra las preferencias relacionadas con Git en Visual Studio. Solo puede ver y editar esta configuración desde Visual Studio.

Para obtener más información sobre cómo acceder a la configuración relacionada con Git de Visual Studio, consulte Exploración de la configuración de Git. A continuación, se describe cómo puede editar cada una de estas configuraciones relacionadas con Git de Visual Studio.

Ubicación predeterminada del repositorio

Puede establecer la carpeta de repositorios predeterminada en la que Visual Studio clonará los repositorios.

La configuración de ubicación del repositorio predeterminado solo está disponible en el ámbito global.

  1. En el menú Git, elija Configuración de Git > y, a continuación, seleccione la vista Configuración global de Git. Esa vista contiene la configuración de ubicación del repositorio predeterminado .

  2. Establezca la ubicación predeterminada del repositorio y seleccione Aceptar para guardar.

    Captura de pantalla que muestra el campo de ubicación predeterminado en Visual Studio.

Cierre las soluciones abiertas que no están en Git al abrir un repositorio

De forma predeterminada, Visual Studio cierra cualquier solución o carpeta abierta en un repositorio de Git cuando se cambia a otro repositorio. La opción Cerrar soluciones abiertas que no están en Git al abrir un repositorio mantiene la solución o carpeta abierta coherente con el repositorio seleccionado. Sin embargo, si la solución o la carpeta no están dentro de un repositorio, es posible que desee mantener la solución abierta al cambiar el repositorio. Puede hacerlo con esta configuración.

Sugerencia

Si empareja esta configuración con Carga automática de la solución al abrir un repositorio de Git, Visual Studio abrirá la solución para el repositorio de Git al que va a cambiar.

La configuración de cerrar soluciones abiertas que no están bajo Git al abrir un repositorio solo está disponible en el ámbito global.

  1. En el menú Git, elija Configuración de Git > y, a continuación, seleccione la vista Configuración global de Git para configurar esta configuración.

  2. Establezca la ubicación predeterminada del repositorio y seleccione Aceptar para guardar.

    Captura de pantalla que muestra la opción Cerrar soluciones abiertas que no están en Git al abrir una configuración de repositorio en el cuadro de diálogo Opciones de Visual Studio.

Los valores válidos son:

  • Yes: al cambiar el repositorio, Visual Studio cierra cualquier solución abierta.
  • No: cuando se cambia el repositorio y la solución o carpeta actual no está en Git, Visual Studio mantendrá abierta la solución o carpeta.
  • Always ask (valor predeterminado): cuando se cambia el repositorio y la solución o carpeta actual no está en Git, Visual Studio preguntará si desea mantener abierta la solución actual.

Habilitación de la descarga de imágenes de autor de orígenes de terceros

Cuando se habilita, Visual Studio descargará una imagen de autor del servicio de imágenes gravatar para su visualización en las vistas de confirmación e historial. Si no ha configurado una imagen de Gravatar, el servicio de imagen gravatar devolverá una imagen generada aleatoriamente automáticamente.

Importante

Para proporcionar imágenes de autor en las vistas de confirmación e historial, Visual Studio crea un hash MD5 mediante la dirección de correo electrónico del autor almacenada en el repositorio activo y envía ese hash a Gravatar. Si Gravatar encuentra un usuario con un hash coincidente, Visual Studio recuperará y mostrará la imagen del usuario. Microsoft no registra ni comparte direcciones de correo electrónico con Gravatar ni con ningún otro tercero.

La opción Habilitar descarga de imágenes de autor de orígenes de terceros solo está disponible en el ámbito global.

  1. En el menú Git, elija Configuración de Git > y, a continuación, seleccione la vista Configuración global de Git. Esa vista contiene la opción Habilitar descarga de imágenes de autor de orígenes de terceros .

  2. Elija si quiere habilitar la descarga de imágenes de autor de orígenes de terceros y seleccione Aceptar para guardar.

    Captura de pantalla que muestra la casilla para habilitar la descarga de imágenes de autor desde un origen de terceros en el cuadro de diálogo Opciones de Visual Studio.

Confirmación de cambios tras la fusión mediante combinación de forma predeterminada

Con la opción Confirmar cambios después de la combinación de forma predeterminada habilitada, Git crea automáticamente una confirmación al combinar una rama.

  • Cuando se activa, todos los comandos git merge emitidos por Visual Studio se ejecutan con la opción --commit.
  • Cuando se desactiva, todos los git merge comandos emitidos por Visual Studio se ejecutan con las --no-commit --no-ff opciones .

Para obtener más información sobre estas opciones de combinación, vea --commit y --no-commit y -no-ff.

La opción Confirmar cambios después de la combinación de forma predeterminada solo está disponible en el ámbito global.

  1. En el menú Git, elija Configuración de Git > y, a continuación, seleccione la vista Configuración global de Git. Esa vista contiene la configuración Confirmar cambios después de la fusión por defecto.

  2. Elija si desea confirmar los cambios después de la combinación de forma predeterminada y seleccione Aceptar para guardar.

    Captura de pantalla que muestra la casilla para confirmar los cambios después de la combinación de forma predeterminada en el cuadro de diálogo Opciones de Visual Studio.

Habilitación de la inserción de --force-with-lease

Con este valor habilitado, puede insertar cambios que sobrescriban el trabajo en una rama remota, si nadie más ha realizado inserciones en la rama remota desde la última extracción.

La opción Habilitar inserción forzada con concesión se corresponde al comando push --force-with-lease. Esta configuración solo está disponible en el ámbito global. De manera predeterminada, la opción Habilitar inserción forzada con concesión está deshabilitada.

  1. En el menú Git, elija Configuración de Git > y, a continuación, seleccione la vista Configuración global de Git. Esa vista contiene el valor Habilitar inserción forzada con concesión.

  2. Elija si quiere habilitar push --force-with-leasey seleccione Aceptar para guardar.

    Captura de pantalla en la que se muestra la casilla para habilitar la inserción forzada con concesión en el cuadro de diálogo Opciones de Visual Studio.

Abrir carpeta en el Explorador de soluciones al abrir un repositorio de Git

Cuando se habilita y se abre un repositorio de Git en Visual Studio, Visual Studio examinará la carpeta del repositorio para ver soluciones, CMakeLists.txtu otros archivos de vista y los mostrará como una lista en el Explorador de soluciones. A continuación, puede cargar una solución o ver el contenido de una carpeta. Esta opción está habilitada de manera predeterminada.

Cuando se deshabilita y se abre un repositorio de Git en Visual Studio, Visual Studio no abrirá la carpeta del repositorio en el Explorador de soluciones y solo es un administrador de repositorios de Git.

  1. En el menú Git, elija Configuración de Git > y, a continuación, seleccione la vista Configuración global de Git para configurar esta configuración.

  2. Elija si quiere habilitar Abrir carpeta en el Explorador de soluciones al abrir un repositorio de Git y seleccione Aceptar para guardar.

    Captura de pantalla que muestra la casilla para abrir la carpeta al abrir un repositorio de Git en el cuadro de diálogo Opciones.

Cargar automáticamente la solución al abrir un repositorio de Git

La opción Cargar automáticamente la solución al abrir un repositorio de Git solo es aplicable si la carpeta Abrir en el Explorador de soluciones al abrir una configuración del repositorio de Git también está habilitada. Al abrir un repositorio de Git en Visual Studio y el examen de carpetas posterior detecta que solo hay una solución presente en el repositorio, Visual Studio carga automáticamente esa solución. Si desactiva esta configuración, el Explorador de soluciones mostrará la única solución presente en el repositorio en la lista de vistas, pero no cargará la solución. Esta configuración está deshabilitada de forma predeterminada

  1. En el menú Git, elija Configuración de Git > y, a continuación, seleccione la vista Configuración global de Git para configurar esta configuración.

  2. Elija si desea habilitar Cargar automáticamente la solución al abrir un repositorio de Git y seleccione Aceptar para guardar.

    Captura de pantalla que muestra la casilla para cargar automáticamente la solución al abrir un repositorio de Git en el cuadro de diálogo Opciones.

Extracción de las ramas automáticamente del repositorio con un doble clic o con la tecla ENTRAR

La ventana Repositorio de Git tiene una lista de ramas mostradas en una estructura de árbol. Seleccione una rama para cambiar el panel historial de confirmaciones para mostrar las confirmaciones de esa rama. Para extraer del repositorio una rama, haga clic con el botón derecho para abrir el menú contextual y seleccione Extraer del repositorio. Con el valor Extracción de las ramas automáticamente del repositorio con un doble clic o con la tecla Entrar habilitado, puede hacer doble clic o presionar la tecla Entrar para extraer del repositorio una rama y mostrar sus confirmaciones.

  1. En el menú Git, elija Configuración de Git > y, a continuación, seleccione la vista Configuración global de Git para configurar esta configuración.

  2. Elija si quiere habilitar Extracción de las ramas automáticamente del repositorio con un doble clic o con la tecla Entrar y seleccione Aceptar para guardar.

    Captura de pantalla en la que se muestra la casilla para extraer ramas del repositorio haciendo doble clic o presionando la tecla ENTRAR en el cuadro de diálogo Opciones.

Edición de archivos de omisión y atributos de Git

Visual Studio proporciona una manera rápida de agregar o editar archivos gitignore y gitattributes en la raíz del repositorio.

La opción para agregar o editar un gitignore archivo o gitattributes solo está disponible en el ámbito del repositorio.

  1. En el menú Git, elija Configuración de Git > y elija la vista General Configuración > del repositorio de Git. Esa vista contiene opciones para editar gitignore o gitattributes archivos.

  2. Elija Editar para abrir el archivo ignore o attribute en una ventana del editor de Visual Studio.

    Captura de pantalla que muestra el botón Editar para los archivos de omitir o atributos en Visual Studio.

Para obtener información sobre cómo configurar .gitignore y .gitattributes archivos, consulte gitignore y gitattributes.

Pasos siguientes