Opciones y preferencias de Git en Visual Studio

  • Artículo

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

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:

  • Valores globales de Git, que se aplican a todos los repositorios de Git para el usuario actual.

  • Valores de repositorio de Git, que se aplican al repositorio de Git activo.

Dentro de esas categorías, los valores pueden ser los siguientes:

  • Valores de archivo de configuración de Git, que puede ver y modificar en Visual Studio, en la línea de comandos o si edita un archivo de configuración de Git. Algunos ejemplos de valores 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 los valores en los archivos de configuración del sistema, globales y locales de Git:

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

    • Los valores globales de archivo de configuración de Git se aplican a todos los repositorios del usuario actual. Los valores globales tienen prioridad sobre los del sistema.

    • Los valores de archivo de configuración de Git local se aplican al repositorio local que contiene el archivo de configuración de Git local. Los valores del sistema tienen prioridad sobre los valores globales.

  • Valores relacionados con Git de Visual Studio, que son valores de Visual Studio relacionados con Git, pero que no se almacenan en ningún archivo de configuración de Git. Solo puede ver y modificar estos valores 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:

  • Explorar los valores de Git
  • Modificar los valores de archivo de configuración de Git
  • Modificar valores relacionados con Git en Visual Studio

Explorar los valores de Git

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.

  1. Para configurar valores de Git en Visual Studio, elija Git > Valores en la barra de menús para abrir la vista Opciones.

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

  2. En la vista Opciones, elija Valores globales de Git para ver los valores que se aplican a todos los repositorios.

    Captura de pantalla de Valores globales de Git en el cuadro de diálogo Opciones de Visual Studio.

    O bien, en la vista Opciones, elija Configuración de repositorios de Git > General para ver los valores que solo se aplican al repositorio de proyectos de Visual Studio actual.

    Captura de pantalla de Configuración de repositorios de Git en el cuadro de diálogo Opciones de Visual Studio.

Modificar los valores de archivo de configuración de Git

Puede ver y editar los valores de configuración de Git en Visual Studio o editar directamente el archivo de configuración de Git correspondiente. Para más información sobre los valores de archivo de configuración de Git, vea Personalización de Git y la documentación de git-config. En las secciones siguientes se describe cómo puede editar cada uno de los valores de archivo de configuración de Git enumerados:

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.

Los valores de nombre y correo electrónico están disponibles en el ámbito global o del repositorio.

En el menú Git, elija Git > Configuración y, después, seleccione la vista Configuración global de Git. Esa vista contiene los valores de nombre y correo electrónico del usuario actual.

Captura de pantalla de los valores 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 de repositorios de Git > General para editar los valores de nombre y correo electrónico del repositorio de proyectos de Visual Studio actual.

Eliminación de ramas remotas durante la captura

Puede indicar a Git que elimine las ramas remotas durante cada captura para quitar ramas obsoletas de seguimiento remoto en el repositorio local que ya no existen en el repositorio remoto correspondiente.

En el menú Git, elija Git > Configuración y, después, 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 este valor en el ámbito global o del repositorio.

En el menú Git, elija Git > Configuración y, después, 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 del valor de fusión mediante cambio de base 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 la 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.

El valor Proveedor de red criptográfica se corresponde al comando git config http.sslBackend. Este valor solo está disponible en el ámbito global.

En el menú Git, elija Git > Configuración y, después, 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 del valor 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 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 mediante cifrado.
  • Unset (valor predeterminado): si este valor no está establecido, 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 necesita credenciales para la solicitud. Cuando esto sucede, Git invoca un asistente para credenciales a fin de obtener las necesarias y, después, vuelve a intentar la solicitud. Puede especificar el asistente para credenciales que usará Git.

El valor Asistente para credenciales se corresponde al comando git config credential.helper. Este valor solo está disponible en el ámbito global.

  1. En el menú Git, elija Git > Configuración y, después, seleccione la vista Configuración global de Git para configurar este valor.

  2. Establezca Credential helper (Aplicación auxiliar de credenciales) en el valor deseado y seleccione Aceptar para guardar.

    Captura de pantalla del valor Asistente para credenciales en el cuadro de diálogo Opciones de Visual Studio.

Los valores válidos son:

Herramientas de diferencias y combinació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 Git > Configuración y, después, seleccione la vista Configuración global de Git. Esa vista contiene los valores de herramientas de diferencias y combinación.

  2. Establezca los valores de herramienta de diferencias y combinación en el valor deseado, y seleccione Aceptar para guardar.

    Captura de pantalla en la que se muestran los valores de herramienta de diferencias y combinación en el cuadro de diálogo Opciones de Visual Studio.

    O bien, elija Configuración de repositorios de Git > General para editar los valores de herramienta de diferencias y combinación del repositorio de proyectos de Visual Studio actual.

Las herramientas de diferencias y combinación válidas son las siguientes:

  • Visual Studio
  • None (valor predeterminado)

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

Remotas

Puede usar el panel Remotos en Configuración de repositorios de Git para agregar, editar o quitar orígenes remotos para el repositorio. Esta valor se corresponde al comando git remote add. 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 desde el que realice la bifurcación, lo que se conoce como repositorio ascendente. En los pasos siguientes se describe cómo agregar un alias upstream.

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

  1. Elija Herramientas > Opciones en la barra de menús para abrir la ventana Opciones. Seleccione Control de código fuente > Configuración de repositorios de Git > Remotos y, después, 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 de repositorios 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. Después, elija Guardar.

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

Otra configuración

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

Los valores siguientes administran preferencias relacionadas con Git en Visual Studio. Solo puede ver y editar estos valores desde Visual Studio.

Para más información sobre cómo acceder a los valores relacionados con Git de Visual Studio, vea Exploración de la configuración de Git. A continuación, se explica cómo puede editar cada uno de estos valores relacionados 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.

El valor Ubicación predeterminada del repositorio solo está disponible en el ámbito global.

  1. En el menú Git, elija Git > Configuración y, después, seleccione la vista Configuración global de Git. Esa vista contiene el valor Ubicación predeterminada del repositorio.

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

    Captura de pantalla en la que se muestra el campo Ubicación predeterminada en Visual Studio.

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

De manera predeterminada, Visual Studio cierra cualquier solución o carpeta abierta en un repositorio de Git al cambiar a otro repositorio. El valor Cerrar las soluciones abiertas que no estén en Git al abrir un repositorio mantiene la solución o carpeta abierta coherente con el repositorio seleccionado. Pero si la solución o la carpeta no está dentro de un repositorio, es posible que quiera mantener la solución abierta al cambiar de repositorio. Puede hacerlo con esta opción.

Sugerencia

Si empareja este valor 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.

El valor Cerrar las soluciones abiertas que no estén en Git al abrir un repositorio solo está disponible en el ámbito global.

  1. En el menú Git, elija Git > Configuración y, después, seleccione la vista Configuración global de Git para configurar este valor.

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

    Captura de pantalla en la que se muestra el valor Cerrar las soluciones abiertas que no estén en Git al abrir un repositorio en el cuadro de diálogo Opciones de Visual Studio.

Los valores válidos son:

  • Yes: al cambiar de repositorio, Visual Studio cierra cualquier solución abierta.
  • No: cuando se cambia de 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 de repositorio y la solución o carpeta actual no está en Git, Visual Studio le preguntará si quiere mantener abierta la solución actual.

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

Cuando se habilita, Visual Studio descargará una imagen de creador del servicio de imágenes Gravatar para mostrarla en las vistas de confirmación e historial. Si no ha configurado una imagen de Gravatar, el servicio de imágenes Gravatar devolverá de forma automática una imagen generada aleatoriamente.

Importante

Para proporcionar imágenes de creador en las vistas de confirmación e historial, Visual Studio crea un hash MD5 mediante la dirección de correo electrónico del creador 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 terceros.

El valor 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 Git > Configuración y, después, seleccione la vista Configuración global de Git. Esa vista contiene el valor 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 en la que se muestra la casilla para habilitar la descarga de imágenes de autor de otros orígenes 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 no se activa, todos los comandos git merge emitidos por Visual Studio se ejecutan con las opciones --no-commit --no-ff.

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

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

  1. En el menú Git, elija Git > Configuración y, después, seleccione la vista Configuración global de Git. Esa vista contiene el valor Confirmar cambios después de la combinación de forma predeterminada.

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

    Captura de pantalla en la que se muestra la casilla para confirmar los cambios después de la combinación 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. Este valor 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 Git > Configuración y, después, 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-lease y 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.

Apertura de una 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 en busca de soluciones, CMakeLists.txt u otros archivos de vista y los mostrará como una lista en Explorador de soluciones. Después, puede cargar una solución o ver el contenido de una carpeta. Esta opción está habilitada de forma predeterminada.

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

  1. En el menú Git, elija Git > Configuración y, después, seleccione la vista Configuración global de Git para configurar este valor.

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

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

Carga automática de la solución al abrir un repositorio de Git

El valor Carga automática de la solución al abrir un repositorio de Git solo es aplicable si el valor Abrir una carpeta en el Explorador de soluciones al abrir un repositorio de Git también está habilitado. Cuando se abre un repositorio de Git en Visual Studio y el examen de carpetas posterior detecta que solo hay una solución en el repositorio, Visual Studio carga automáticamente esa solución. Si desactiva este valor, en el Explorador de soluciones se mostrará la única solución presente en el repositorio en la lista de vistas, pero no se cargará. Este valor está deshabilitado de manera predeterminada

  1. En el menú Git, elija Git > Configuración y, después, seleccione la vista Configuración global de Git para configurar este valor.

  2. Elija si quiere habilitar Carga automática de la solución al abrir un repositorio de Git y seleccione Aceptar para guardar.

    Captura de pantalla en la que se 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 que se muestran en una estructura de árbol. Seleccione una rama para cambiar al panel del historial de confirmaciones y mostrar las confirmaciones de la rama seleccionada. 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 Git > Configuración y, después, seleccione la vista Configuración global de Git para configurar este valor.

  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 archivo gitignore o gitattributes solo está disponible en el ámbito del repositorio.

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

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

    Captura de pantalla en la que muestra el botón Editar para los archivos de omisión o atributo en Visual Studio.

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

Pasos siguientes

Uso compartido del código con inserciónRevisión de solicitudes de incorporación de cambios