Búsqueda de código funcional
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
Busque el código que necesita más rápido con la búsqueda de código funcional. En este artículo se explica cómo refinar la búsqueda entre repositorios mediante tipos de código y otras funciones con la extensión de Marketplace code Search para Azure DevOps.
Requisitos previos
- Niveles de acceso:
- Acceso básico:
- Para usar la búsqueda de código, debe tener al menos acceso básico.
- Para acceder al código de un proyecto privado, debe tener al menos acceso básico.
- Acceso a las partes interesadas:
- Los usuarios con acceso a partes interesadas no tienen acceso al código, por lo que no pueden buscar código.
- Los usuarios con acceso de partes interesadas para un proyecto público tienen acceso completo al código, por lo que pueden buscar código.
- Acceso básico:
- Resultados de la búsqueda:
- Resultados basados en acceso: al buscar en toda la organización o colección, solo se muestran los resultados para los que un miembro del proyecto tiene acceso.
- Niveles de acceso:
- Acceso básico:
- Para usar la búsqueda de código, debe tener al menos acceso básico.
- Para acceder al código de un proyecto privado, debe tener al menos acceso básico.
- Acceso a las partes interesadas:
- Los usuarios con acceso a partes interesadas no tienen acceso al código, por lo que no pueden buscar código.
- Acceso básico:
- Resultados de la búsqueda:
- Resultados basados en acceso: al buscar en toda la organización o colección, solo se muestran los resultados para los que un miembro del proyecto tiene acceso.
- Herramientas:
- Instale Code Search.
Procedimientos recomendados de búsqueda de código
- Iniciar amplio: comience con una búsqueda amplia y, a continuación, use operadores de filtro para restringirlo por proyecto, repositorio, ruta de acceso, nombre de archivo, etc.
- Use caracteres comodín y operadores booleanos: si no conoce el término exacto, use caracteres comodín para expandir los operadores booleanos y de búsqueda para refinarlo.
- Mantenga el puntero para obtener más información: para obtener más información sobre un elemento de código, mantenga el puntero sobre él y use el menú contextual para buscar ese texto en todos los proyectos y archivos.
- Funcionalidad de código de seguimiento: use el menú contextual para buscar elementos relacionados como definiciones y referencias en un archivo o en los resultados de búsqueda para realizar un seguimiento de cómo funciona el código.
- Usar filtros de tipo de código: para buscar la implementación de una API u otro elemento de código, use filtros de tipo de código para buscar tipos específicos de código como:
- Definiciones
- Referencias
- Funciones
- Comentarios
- Cadenas
- Espacios de nombres, etc.
Nota:
La búsqueda de código no funciona para repositorios bifurcados.
Funciones para buscar tipos específicos de código
Para crear la consulta más rápido, elija funciones y palabras clave en la lista desplegable a medida que escriba texto. Seleccione Mostrar más para ver todas las opciones. Puede combinar diferentes funciones según sea necesario.
También puede usar filtros de la columna izquierda para restringir la búsqueda. Mostrar más muestra todas las funciones y palabras clave.
O bien, puede escribir las funciones y los parámetros en el cuadro de búsqueda. En la tabla siguiente se enumeran las funciones para buscar tipos o miembros específicos en el código de C#, C, C++, Java y Visual Basic.NET.
| Para buscar código donde findThis aparece como ... | ... buscar argumento arg:findThis |
|---|---|
| Argument | arg:findThis Deprecated in July 2019 |
| Tipo base | basetype:findThis |
| Función de llamada | llamador:findThis Deprecated in July 2019 |
| Definición o declaración de clase | class:findThis |
| Declaración de clase | classdecl:findThis Merged with class: |
| Definición de clase | classdef:findThis Merged with class: |
| Comentario | comment:findThis |
| Constructor | ctor:findThis Merged with method: |
| Declaración | decl:findThis |
| Definición | def:findThis |
| Destructor | dtor:findThis Merged with method: |
| Enumerador | enum:findThis |
| Extern | extern:findThis Deprecated in July 2019 |
| Campo | field:findThis |
| Función Friend | friend:findThis Deprecated in July 2019 |
| Función | func:findThis Merged with method: |
| Declaración de función | funcdecl:findThis Merged with method: |
| Definición de función | funcdef:findThis Merged with method: |
| Global | global:findThis Deprecated in July 2019 |
| Encabezado | header:findThis Deprecated in July 2019 |
| Interfaz | interface:findThis |
| Macro | macro:findThis |
| Definición de macro | macrodef:findThis Merged with macro: |
| Referencia de macros | macroref:findThis Merged with macro: |
| Método | method:findThis |
| Declaración de método | methoddecl:findThis Merged with method: |
| Definición del método | methoddef:findThis Merged with method: |
| Espacio de nombres | namespace:findThis |
| Propiedad | prop:findThis |
| Referencia | ref:findThis |
| Literal de cadena | strlit:findThis |
| Estructura | struct:findThis Merged with type: |
| Declaración de estructura | structdecl:findThis Merged with type: |
| Definición de estructura | structdef:findThis Merged with type: |
| Argumento de plantilla | tmplarg:findThis Deprecated in July 2019 |
| Especificación de plantilla | tmplspec:findThis Deprecated in July 2019 |
| Tipo | type:findThis |
| Definición de tipo | typedef:findThis Merged with type: |
| Unión | union:findThis Deprecated in July 2019 |
Funciones para seleccionar proyectos, repositorios, rutas de acceso y archivos
Las funciones facilitan la búsqueda a ubicaciones especificadas, tipos específicos de archivos dentro de estas ubicaciones o nombres de archivo especificados. Restrinja la búsqueda a una ubicación específica mediante los projfiltros , repoo path . Combine y coincida con las siguientes funciones según sea necesario.
| Uso | Ejemplo |
|---|---|
| Busque todas las apariciones de la palabra QueueJobsNow en el proyecto fabrikam. | QueueJobsNow proj:Fabrikam |
| Busque todas las apariciones de la palabra QueueJobsNow en el repositorio contoso. | QueueJobsNow repo:Contoso |
| Busque todas las apariciones de la palabra QueueJobsNow en la ruta de acceso VisualStudio/Services/Framework y sus subrutas. | QueueJobsNow path:VisualStudio/Services/Framework |
| Busque todas las apariciones de la palabra QueueJobsNow en la ruta de acceso */Doc*/Framework/* y */Doc*/*/*/Framework/* y sus subrutas. El patrón de globbing (**) coincide con cero o más caracteres en varios segmentos. Por ejemplo, path:**/Doc**/Framework también coincide con abc/DocTest/gh/ijk/mnop/Framework/ | QueueJobsNow path:**/Doc**/Framework |
| Busque todas las apariciones de la palabra QueueJobsNow en la ruta de acceso */Doc*/Framework/* y sus subrutas y nombre de archivo Test*.txt (Usar patrón de Globbing **). Por ejemplo, path:**/Doc**/Framework/**/Test*.txt coincide también con abc/def/Doc A/gh/Framework/TestMisc.Txt | QueueJobsNow path:**/Doc**/Framework/**/Test*.txt |
| Incluya el argumento en el filtro entre comillas dobles si contiene un espacio. | QueueJobsNow path:"VisualStudio/Windows Phones and Devices/Services" |
| Busque todas las apariciones de la palabra QueueJobsNow en todos los archivos donde el nombre de archivo comienza con queueRegister. | QueueJobsNow file:queueRegister* |
| Busque todos los archivos con el nombre QueueRegister sin una extensión. Use comillas para buscar archivos sin extensiones. | file:"queueRegister" |
| Busque todas las apariciones de la palabra QueueJobsNow solo en archivos de código fuente de C#. Una cadena de búsqueda de texto sin formato que no incluye funciones de tipo de archivo también busca archivos donde la cadena coincide con parte del nombre de archivo. | QueueJobsNow ext:cs |
Buscar elementos relacionados u otros términos
Code Search le permite expandir interactivamente la búsqueda en función de los resultados anteriores. Por ejemplo, puede ampliar la búsqueda a archivos relacionados al realizar el seguimiento o depurar código.
Haga clic con el botón derecho en un término en el archivo e inicie una nueva búsqueda de otros archivos con el mismo término. Puede buscarlo como texto o como definición o referencia si es un nombre de objeto.
Para obtener más información, consulte Introducción a la búsqueda.
Más operaciones de búsqueda de código
Estas son algunas funciones de búsqueda de código más. Puede buscar tipos de código en archivos de C#, C, C++, Java y Visual Basic.NET. Para abrir los resultados de la búsqueda en una nueva pestaña, seleccione Ctrl + Entrar en el cuadro de búsqueda principal. Para cambiar a la nueva pestaña de Google Chrome, seleccione Ctrl + Mayús + Entrar.
| Uso | Ejemplo |
|---|---|
| Buscar todos los comentarios | History:Keyword |
| Buscar todas las instancias de comentarios de "ToDo" en el código | Seleccione comment: y escriba todo |
| Buscar en ubicaciones específicas, como dentro de una ruta de acceso determinada | Uso de una cadena de búsqueda como Driver path:MyShuttle/Server |
| Buscar archivos por nombre o simplemente por extensión de archivo | Driver file:GreenCabs.cs. La cadena error ext:resx de búsqueda podría ser útil si desea revisar todas las cadenas de error del código. Incluso si la cadena de búsqueda de texto sin formato coincide con parte de un nombre de archivo, el archivo aparece en la lista de archivos encontrados. Esta búsqueda funciona sin buscar funciones específicas de tipo de archivo. |
Búsqueda de proyectos y repositorios de Git
Un proyecto de Git tiene una lista de repositorios. Para expandir la búsqueda, active los cuadros del proyecto y del repositorio. Puede buscar en todos o más proyectos o menos proyectos y repositorios. Si hay muchos proyectos o repositorios, seleccione Mostrar más para verlos todos.
La búsqueda de código puede indexar diferentes ramas en un repositorio de Git. Solo indexa archivos en la rama predeterminada de los repositorios de Git de forma predeterminada. La rama predeterminada es main. Para indexar otras ramas, vaya a la pestaña Opciones de la sección Repositorios de la página de configuración del proyecto.
Nota:
De forma predeterminada, la búsqueda de código busca la cadena especificada en la rama principal o predeterminada de un repositorio. Sin embargo, puede restringir la búsqueda especificando un filtro para una rama específica.
Buscar proyectos de TFVC
Los proyectos de TFVC solo muestran las carpetas que puede leer. No puede ver ningún otro proyecto o carpeta. Para filtrar la búsqueda, elija carpetas del árbol.
Sugerencia
Búsqueda de código guarda la última configuración, como el proyecto y el repositorio o la ruta de acceso que ha buscado. Cuando quiera buscar en otro ámbito, seleccione Borrar todos los vínculos para desactivar las casillas y buscar en todos los proyectos. La búsqueda de código resalta las primeras 100 visitas o coincidencias en los archivos de destino en el panel de resultados.
Buscar código con la API REST
Puede usar las API para ampliar o complementar las funcionalidades enumeradas en este artículo. Para obtener información sobre la búsqueda de código con la API REST, consulte Capturar resultados de búsqueda de código.