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

CodeLens le permite 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, revisiones de código y pruebas unitarias.

Nota

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.

Nota

CodeLens solo está disponible en las ediciones Visual Studio Enterprise y Professional. No está disponible en la edición Visual Studio Community.

Vea dónde y cómo se usan las partes individuales del código de la solución:

Indicadores CodeLens en el editor de código

Póngase en contacto con su equipo para informar de los cambios en el código sin salir del editor:

CodeLens - Ponerse en contacto con su equipo

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.

  1. Elija el indicador referencias o presione Alt+2.

    Referencias de CodeLens

    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.

    CodeLens - Leer referencia

  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.

CodeLens - Referencias en el mapa de código

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:

  • Edición Visual Studio Enterprise o Professional

  • Azure DevOps Services, Team Foundation Server 2013 o posterior o Git

  • Skype Empresarial para ponerse en contacto con su equipo desde el editor de código.

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 (indicadores code-element-level). Si el repositorio Git está hospedado en TfGit, también obtendrá vínculos a elementos de trabajo TFS.

Indicadores de nivel de elemento del código

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, en la parte inferior de la ventana (indicadores de nivel de archivo).

Indicadores de nivel de archivo de CodeLens

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.

Esto es lo que se ve cuando se usa el Control de versiones de Team Foundation (TFVC) en Team Foundation Server o Azure DevOps Services.

CodeLens: Obtener el historial de cambios del código de TFVC

El período de tiempo predeterminado son los últimos 12 meses. Si el código se almacena en Team Foundation Server, puede cambiar el periodo de tiempo ejecutando el comando TFSConfig junto con el comando CodeIndex y la marca /indexHistoryPeriod.

Para ver un historial detallado de todos los cambios, incluidos los de hace más de un año, elija Mostrar todos los cambios de archivo:

Mostrar todos los cambios de código

Se abre la ventana Historial:

Ventana de historial para todos los cambios de código

Esto es lo que se ve cuando los archivos están en un repositorio Git y se elige el indicador de cambios en el nivel de elemento de código:

CodeLens: Obtener el historial de cambios del código de Git

Indicadores de nivel de archivo

Busque los cambios realizados en todo un archivo en los indicadores de nivel de archivo de la parte inferior de la ventana:

CodeLens: Obtener detalles del archivo de código

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 ese 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.

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

CodeLens: Ver el historial de cambios de código como un gráfico

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.

CodeLens: Buscar cambios en la bifurcación actual

Puede saber cuántas personas realizaron cambios en el código y cuántos cambios se realizaron en la rama Main presionando Alt+6:

CodeLens: Buscar el número de cambios de la bifurcación

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 cambios o presione Alt+6:

CodeLens: Buscar cuándo se creó una bifurcación en el código

Buscar cambios entrantes de otras bifurcaciones

CodeLens: Buscar cambios del código en otras bifurcaciones

Puede ver los cambios entrantes. En la siguiente captura de pantalla, se realizó una corrección de errores en la rama "Dev":

CodeLens: Cambiar los elementos verificados a otra bifurcación

Puede revisar el cambio sin salir de la rama actual ("Main"):

CodeLens: Ver cambios entrantes desde otra bifurcación

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:

CodeLens: búsqueda de cuándo se combinaron los cambios

Por ejemplo, el código de la bifurcación Main ahora incluye la corrección de errores de la bifurcación "Dev":

CodeLens - Cambios combinados entre bifurcaciones

Comparar un cambio entrante con la versión local

Compare un cambio entrante con la versión local presionando MAYÚS+F10, o haciendo doble clic en el conjunto de cambios.

CodeLens: Comparar cambios entrantes con locales

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:
CodeLens: Cambiar desde icono de bifurcación actual La bifurcación actual
CodeLens: Cambiar desde icono de bifurcación primaria La bifurcación primaria
CodeLens: Cambiar desde icono de bifurcación secundaria Una bifurcación secundaria
CodeLens: Cambiar desde icono de bifurcación del mismo nivel Una bifurcación del mismo nivel
CodeLens: Cambiar desde icono de bifurcación alejada Una bifurcación más alejada que una primaria, secundaria o del mismo nivel
CodeLens: Fusionar mediante combinación desde icono primario Una combinación de la bifurcación primaria y una bifurcación secundaria
CodeLens: Fusionar mediante combinación desde icono de ramificación secundaria Una combinación de una bifurcación secundaria con la bifurcación secundaria
CodeLens: Combinar desde icono de bifurcación no relacionada 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.

CodeLens - Buscar elementos de trabajo para código específico

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.

CodeLens - Ver solicitudes de revisión de código

Errores vinculados

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

CodeLens - Buscar errores vinculados a conjuntos de cambios

Ponerse en contacto con el propietario de un elemento

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

Ponerse en contacto con el propietario de un elemento

Abra el menú contextual de un elemento para ver las opciones de contacto. Si tiene Lync o Skype Empresarial instalado, verá estas opciones:

Opciones de contacto para un elemento

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.

    CodeLens - Elegir estado de la prueba en el editor de código

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

    CodeLens - Ver pruebas unitarias no ejecutadas aún

  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.

    CodeLens - Ir a la definición de la prueba unitaria

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

    CodeLens - Ver resultado de la prueba unitaria

  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.

Números de acceso mediante el teclado

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.

CodeLens: Activar o desactivar los indicadores

Active o desactive 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.

Activar o desactivar los indicadores de los archivos

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.

  • Si el código está almacenado en TFS, asegúrese de que la indización de código esté activada. Para ello, use el comando CodeIndex con el comando TSF Config.

  • Los indicadores relacionados con 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.

Sugerencia

CodeLens no está disponible en la edición Visual Studio Community.

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 o TFS. 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 o TFS.

P: ¿Por qué no veo los indicadores?

R: Los indicadores de Skype no aparecen si no inició sesión en Skype Empresarial, si no lo tiene instalado o si su configuración no es compatible. Pero podrá seguir enviando un correo electrónico:

CodeLens - Ponerse en contacto con el propietario del conjunto de cambios por correo

¿Qué configuraciones de Skype y Lync se admiten?

  • Skype Empresarial (32 o 64 bits)

  • Solo Lync 2010 o posterior (32 bits o 64 bits), pero no Lync Basic 2013 con Windows 8.1

CodeLens no admite tener instaladas distintas versiones de Lync o Skype. Puede que no estén localizadas para todas las versiones localizadas de Visual Studio.

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

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

CodeLens - Cambiar la configuración de fuente y color

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 Icono del Dock para acoplar CodeLens como ventana.

Acoplar el botón en la ventana del indicador de CodeLens

Ventana acoplada de referencias de CodeLens

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:

    Botón de actualización de referencias de CodeLens

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

    Elemento de menú Actualizar indicadores de equipo CodeLens

  • 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: ¿Puedo administrar cómo CodeLens procesa código para mostrar el historial y los elementos vinculados?

R: Sí. Si el código está en TFS, use el comando CodeIndex con el comando TSF Config.

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.

Vea también