Buscar cambios en el código y otro historial con CodeLens

Con CodeLens, puede averiguar qué ocurrió con el código mientras sigue centrado en su trabajo sin dejar el editor. Puede buscar referencias de una parte del código, cambios de código, errores vinculados, elementos de trabajo de Azure DevOps, revisiones de código y pruebas unitarias.

Nota:

CodeLens está disponible en la edición Community de Visual Studio. Sin embargo, los indicadores de control de código fuente no están disponibles en esta edición.

CodeLens puede mostrar dónde y cómo se usan las partes individuales del código en la solución.

Para elegir qué indicadores desea ver, o para activar o desactivar CodeLens, vaya a Herramientas>Opciones>Editor de texto>Todos los lenguajes>CodeLens.

Buscar referencias al código

Puede buscar referencias en código de C# o de Visual Basic. Esta es la manera de hacerlo.

1. En el editor de código, seleccione el indicador referencias o presione Alt+2.

   Nota:

   Si el indicador muestra 0 referencias, significa que no tiene ninguna referencia de código de C# o Visual Basic. Pero podría haber referencias en otros elementos, como archivos .xaml y .aspx.

2. Para ver el código de referencia, mueva el mouse sobre la referencia en la lista.

3. Para abrir el archivo que contiene la referencia, haga doble clic en la referencia.

Mapas de código

Para ver las relaciones entre este código y sus referencias, cree un mapa de código. En el menú contextual del mapa de código, seleccione Mostrar todas las referencias.

Buscar cambios en el código

Inspeccione el historial del código para averiguar qué ocurrió. O bien, revise esos cambios antes de combinarlos con su código para saber cómo los cambios de otras bifurcaciones podrían afectarlo.

Necesita:

• Visual Studio Enterprise o Visual Studio Professional

• Git o Azure DevOps Server (anteriormente Team Foundation Server) o Control de versiones de Team Foundation

Para el código de C# o Visual Basic que está almacenado con control de versiones de Team Foundation (TFVC) o Git, los detalles de CodeLens se obtienen en los niveles de clase y método (indicadorescode-element-level).

Para otros tipos de archivos que no son .cs o .vb, los detalles de CodeLens se obtienen para todo el archivo en un mismo lugar (indicadores de nivel de archivo).

Indicadores de nivel de elemento del código

Los indicadores de nivel de elemento de código permiten ver quién cambió el código y qué cambios se realizaron. Los indicadores de nivel de elemento de código están disponibles para el código de C# y Visual Basic.

También puede ver el historial de cambios al usar Control de versiones de Team Foundation (TFVC) en Azure DevOps Services.

El período de tiempo predeterminado son los últimos 12 meses.

Para ver un historial detallado de todos los cambios, incluidos los de hace más de un añom seleccione Mostrar todos los cambios de archivo, que abre una ventana Historial.

En la ventana Historial, puede ver todos los archivos que se encuentran en un repositorio de Git. A continuación, puede seleccionar el indicador de cambios de nivel de elemento de código para obtener más detalles.

Indicadores de nivel de archivo

También puede ver los indicadores de nivel de archivo de un archivo completo.

Nota:

Los indicadores de nivel de archivo no están disponibles para los archivos de C# y Visual Basic.

Para obtener más detalles sobre un cambio, haga clic con el botón secundario en el elemento. En función de si está usando TFVC o Git, hay diferentes opciones para comparar las versiones del archivo, ver detalles y realizar el seguimiento del conjunto de cambios, obtener la versión seleccionada del archivo y enviar un correo electrónico al autor del cambio. Algunos de estos detalles aparecen en Team Explorer si lo ha habilitado; de lo contrario, estos detalles aparecen en la pestaña Cambios de Git y también pueden aparecer en la barra de desplazamiento horizontal en la parte inferior del editor.

También puede ver quién cambió el código a lo largo del tiempo, lo que puede ayudarle a encontrar patrones en los cambios del equipo y evaluar su impacto.

A partir de visual Studio 2022, versión 17.12 Preview 2, puede mostrar u ocultar indicadores de nivel de archivo en la barra de desplazamiento horizontal del editor. Para ocultar los indicadores, abra Opciones de herramientas > Editor > > de texto Avanzado y, a continuación, deshabilite la opción Mostrar indicador de nivel de archivo CodeLens. Esta opción afecta a la visibilidad de los tipos de archivo que tienen el control CodeLens de nivel de archivo en la barra de desplazamiento del editor inferior, como XAML, HTML y CSS, y no afecta a los archivos que contienen CodeLens insertados.

Buscar cambios en la bifurcación actual

Su equipo puede tener varias ramas, por ejemplo, una rama Main y una rama Development secundaria, para reducir el riesgo de que el código estable se interrumpa. Puede saber cuántas personas realizaron cambios en el código y cuántos cambios se realizaron en la rama principal presionando Alt+6.

Buscar cuándo se bifurcó el código

Para buscar cuándo se bifurcó el código, navegue hasta el código de la rama secundaria. Después, seleccione el indicador de cambios (o presione Alt+6).

Buscar cambios entrantes de otras bifurcaciones

Puede ver los cambios entrantes. Además, no es necesario dejar la rama actual para revisar un cambio.

Buscar cuándo se combinan los cambios

Puede ver cuándo se combinaron los cambios, para que pueda determinar qué cambios se incluyen en la rama.

Comparar un cambio entrante con la versión local

Para comparar un cambio entrante con la versión local, haga doble clic en el conjunto de cambios o presione Mayús+F10.

Iconos de rama

El icono de la columna Rama indica cómo se relaciona la rama en la que está trabajando con la rama.

Icono	El cambio provino de:
	La bifurcación actual
	La bifurcación primaria
	Una bifurcación secundaria
	Una bifurcación del mismo nivel
	Una bifurcación más alejada que una primaria, secundaria o del mismo nivel
	Una combinación de la bifurcación primaria y una bifurcación secundaria
	Una combinación de una bifurcación secundaria con la bifurcación secundaria
	Una combinación de una bifurcación no relacionada (combinación sin base)

Elementos de trabajo vinculados.

Buscar elementos de trabajo vinculados seleccionando el indicador elementos de trabajo o presionando Alt+8.

Revisiones de código vinculadas

Buscar revisiones de código vinculadas seleccionando el indicador revisiones. Para usar el teclado, mantenga presionada la tecla Alt y, después, presione Flecha izquierda o Flecha derecha para navegar por las opciones de indicador.

Errores vinculados

Buscar errores vinculados seleccionando el indicador errores o presionando Alt+7.

Ponerse en contacto con el propietario de un elemento

Buscar el autor de un elemento seleccionando el indicador autores o presionando Alt+5.

También puede abrir el menú contextual de un elemento para ver las opciones de contacto. (Si tiene Teams instalado, tiene opciones de comunicación adicionales disponibles).

Pruebas unitarias asociadas

Puede buscar qué pruebas unitarias existen para el código de C# o Visual Basic sin tener que abrir el Explorador de pruebas.

1. Vaya al código de la aplicación que tenga código pruebas unitarias asociado.

2. Si todavía no lo ha hecho, compile la aplicación para que cargue los indicadores de prueba de CodeLens.

3. Revise las pruebas para el código presionando Alt+3.

4. Si ve un icono de advertencia , las pruebas aún no se han ejecutado, así que ejecútelas.

5. Para revisar la definición de una prueba, haga doble clic en el elemento de prueba en la ventana de indicador de CodeLens para abrir el archivo de código en el editor.

6. Para revisar los resultados de la prueba, elija el indicador de estado de la misma ( o ) o presione Alt+1.

7. Para ver cuántas personas cambiaron esta prueba, quién la cambió o cuántos cambios se realizaron, busque el historial del código y los elementos vinculados.

Accesos directos del teclado

Para usar el teclado para seleccionar los indicadores, mantenga presionada la tecla Alt para mostrar las teclas numéricas relacionadas, luego presione el número que se corresponda con el indicador que quiere seleccionar.

Nota:

Para seleccionar el indicador revisiones, mantenga pulsada la tecla Alt mientras usa las teclas de flecha derecha e izquierda para navegar.

Preguntas y respuestas

P: ¿Cómo activo o desactivo CodeLens o elijo qué indicadores ver?

R.: Puede activar o desactivar todos los indicadores, excepto el indicador de referencias. Vaya a Herramientas>Opciones>Editor de texto>Todos los lenguajes>CodeLens.

Cuando se activen los indicadores, también podrá abrir las opciones de CodeLens desde estos. Además, puede activar o desactivar los indicadores de nivel de archivo de CodeLens con los iconos de botón de contenido adicional de la parte inferior de la ventana del editor.

P: ¿Dónde está CodeLens?

R: CodeLens aparece en el código de C# y Visual Basic, en el nivel de método, de clase, de indexador y de propiedad. CodeLens aparece en el nivel de archivo para todos los demás tipos de archivos.

• Asegúrese de que CodeLens esté activado. Vaya a Herramientas>Opciones>Editor de texto>Todos los lenguajes>CodeLens.

• Los indicadores relacionados con Azure DevOps aparecen solo cuando los elementos de trabajo se vinculan al código y cuando tiene permisos para abrir los elementos de trabajo vinculados. Confirme que tiene permisos de miembro del equipo.

• Los indicadores de pruebas unitarias no aparecen cuando el código de la aplicación no tiene pruebas unitarias. Dichos indicadores aparecen automáticamente en los proyectos de prueba. Si sabe que el código de la aplicación tiene pruebas unitarias, pero los indicadores de prueba no aparecen, pruebe a compilar la solución (CTRL+Mayús+B).

Sugerencia

CodeLens está disponible en la edición Visual Studio Community. Sin embargo, los indicadores de control de código fuente no están disponibles en esta edición.

P: ¿Por qué no veo los detalles de los elementos de trabajo de una confirmación?

R: Esto podría deberse a que CodeLens no puede encontrar los elementos de trabajo en Azure Boards. Compruebe que está conectado al proyecto que tenga esos elementos de trabajo y que tiene permisos para verlos. Los detalles de elementos de trabajo también podrían no mostrarse si la descripción de confirmación tiene información incorrecta sobre los identificadores de elementos de trabajo en Azure Boards.

P: ¿Cómo se cambian la fuente y el color de CodeLens?

R: Vaya Herramientas>Opciones>Entorno>Fuentes y colores.

Para usar el teclado:

1. Presione Alt+T+O para abrir el cuadro de diálogo Opciones.

2. Presione Flecha arriba o Flecha abajo para ir al nodo Entorno y, a continuación, presione Flecha izquierda para expandir el nodo.

3. Presione Flecha abajo para ir a Fuentes y colores.

4. Presione TAB para ir a la lista Mostrar configuración para y, a continuación, presione Flecha abajo para seleccionar CodeLens.

P: ¿Se puede mover la pantalla de aviso de CodeLens?

R.: Sí, elija para acoplar CodeLens como ventana.

P: ¿Cómo se actualizan los indicadores?

R: Esto depende del indicador:

• Referencias: este indicador se actualiza automáticamente cuando cambia el código. Si el indicador Referencias está acoplado como una ventana independiente, actualice el indicador seleccionando Actualizar.

• Equipo: actualice estos indicadores seleccionando Actualizar indicadores de equipo CodeLens desde el menú contextual.

• Prueba: Buscar pruebas unitarias para el código para actualizar el indicador Prueba.

P: ¿Qué es la "Versión local"?

R: La flecha Versión local apunta al conjunto de cambios más reciente de la versión local de un archivo. Cuando el servidor tiene conjuntos de cambios más recientes, estos aparecen encima o debajo de la flecha Versión local , según el orden usado para ordenar los conjuntos de cambios.

P: Los indicadores de prueba de CodeLens ya no aparecen en el archivo cuando abro la solución por primera vez. ¿Cómo puedo cargarlos?

R: Recompile el proyecto para obtener los indicadores de prueba de CodeLens que quiera cargar en el archivo. Para mejorar el rendimiento, Visual Studio ya no obtiene la información de origen de los indicadores de prueba al cargar los archivos de código. Los indicadores de prueba se cargan después de la compilación o al desplazarse a una prueba haciendo doble clic en ella en el Explorador de pruebas.

Contenido relacionado

• Documentación sobre el control de versiones en Visual Studio.
• Características del editor de código