Note
En este artículo se describe la sintaxis de la búsqueda de código heredada, que solo debes usar con el punto de conexión de la API de REST para la búsqueda de código.
Para obtener información sobre la sintaxis de búsqueda de código que puede usar en GitHub, consulta Descripción de la sintaxis de GitHub Code Search.
Puedes buscar globalmente en todo GitHub Enterprise Cloud o limitar tu búsqueda a un repositorio o a una organización en particular Para más información, consulta Acerca de la búsqueda en GitHub.
Únicamente puedes buscar código utilizando estos calificadores de búsqueda de código. Los calificadores de búsqueda especialmente para repositorios, usuarios o confirmaciones de cambios, no funcionarán cuando busques código.
Tip
- Para una lista de sintaxis de búsqueda que puedas agregar a cualquier calificador de búsqueda para mejorar aún más los resultados, consulta "Entender la sintaxis de búsqueda".
- Utiliza comillas alrededor de los términos de búsqueda que contengan varias palabras. Por ejemplo, si quiere buscar incidencias con la etiqueta "En curso", tendría que buscar
label:"in progress"
. Buscar no distingue entre mayúsculas y minúsculas.
Consideraciones para la búsqueda de código
Debido a la complejidad de la búsqueda de código, hay algunas restricciones sobre cómo se realizan las búsquedas:
- Debes haber iniciado sesión en una cuenta personal en GitHub Enterprise Cloud para buscar el código en todos los repositorios públicos.
- El código de bifurcaciones solo se puede buscar si la bifurcación tiene más estrellas que el repositorio primario y el repositorio bifurcado tiene al menos una confirmación insertada después de crearse. Las bifurcaciones con menos estrellas que el repositorio primario o las no confirmaciones no se indexan para la búsqueda de código. Para incluir bifurcaciones con más estrellas que sus elementos primarios y al menos una confirmación enviada en los resultados de búsqueda, deberás agregar
fork:true
ofork:only
a la consulta. Para más información, consulta Buscar en bifurcaciones. - Para la búsqueda de código solo se indexa la rama predeterminada.
- Solo los archivos menores de 384 KB son indexados.
- Se pueden buscar hasta 4000 repositorios privados e internos. Estos 4000 repositorios serán los que se han actualizado más recientemente de los primeros 10 000 repositorios privados e internos a los que tienes acceso.
- Solo se pueden buscar repositorios con menos de 500 000 archivos.
- Solo se pueden hacer búsquedas en los repositorios que han tenido actividad o que se han devuelto en los resultados de búsqueda dentro del último año.
- Con la excepción de las búsquedas de
filename
, siempre debe incluir por lo menos un término de búsqueda cuando busque en el código fuente. Por ejemplo, la búsqueda delanguage:javascript
no es válida, mientras que la deamazing language:javascript
sí lo es. - A lo sumo, los resultados de búsqueda pueden mostrar dos fragmentos del mismo archivo, pero puede haber más resultados dentro del archivo.
- No puede utilizar los siguientes caracteres comodines como parte de la consulta de búsqueda:
. , : ; / \ ` ' " = * ! ? # $ & + ^ | ~ < > ( ) { } [ ] @
. La búsqueda simplemente ignorará estos símbolos.
Buscar según los contenidos del archivo o la ruta de archivo
Con el calificador in
puede restringir la búsqueda a los contenidos del archivo del código fuente, de la ruta del archivo o de ambos. Cuando omites este calificador, únicamente se busca el contenido del archivo.
Calificador: | Ejemplo |
---|---|
in:file | octocat in:file coincide con el código donde "octocat" aparece en el contenido del archivo. |
in:path | octocat in:path coincide con el código donde "octocat" aparece en el contenido de la ruta de acceso. |
in:file,path | octocat in:file, path coincide con el código donde "octocat" aparece en el contenido del archivo o de la ruta de acceso del archivo. |
Buscar dentro de los repositorios de un usuario u organización
Para buscar el código en todos los repositorios que son propiedad de una determinada organización o usuario, puedes utilizar el calificador user
o org
. Para buscar el código en un repositorio específico, puede utilizar el calificador repo
.
Calificador: | Ejemplo |
---|---|
user:USERNAME | user:defunkt extension:rb coincide con el código de @defunkt que termina en .rb. |
org:ORGNAME | org:github extension:js coincide con el código de GitHub que termina en .js. |
repo:USERNAME/REPOSITORY | repo:mozilla/shumway extension:as coincide con el código del proyecto shumway de @mozilla que termina en .as. |
Buscar por ubicación del archivo
Puede utilizar el calificador path
para buscar el código fuente que aparece en una ubicación específica en un repositorio. Utilice path:/
para buscar archivos que se encuentren en el nivel raíz de un repositorio. O especifica un nombre de directorio o ruta a un directorio para buscar archivos que estén ubicados dentro de ese directorio o alguno de sus subdirectorios.
Calificador: | Ejemplo |
---|---|
path:/ | octocat filename:readme path:/ coincide con los archivos léame con la palabra "octocat" que se encuentran en el nivel raíz de un repositorio. |
path:DIRECTORY | form path:cgi-bin language:perl coincide con los archivos Perl con la palabra "form" en el directorio cgi-bin, o en cualquiera de sus subdirectorios. |
path:PATH/TO/DIRECTORY | console path:app/public language:javascript coincide con los archivos de JavaScript con la palabra "console" en el directorio app/public, o en cualquiera de sus subdirectorios (incluso si están en app/public/js/form-validators). |
Buscar por lenguaje
Puedes buscar el código basado en el lenguaje en que está escrito. El calificador language
puede ser el nombre o alias del lenguaje. Para obtener una lista completa de los lenguajes admitidos con sus nombres y alias, consulta el repositorio github-linguist/linguist.
Calificador: | Ejemplo |
---|---|
language:LANGUAGE | element language:xml size:100 coincide con el código con la palabra "element" que se marca como XML y tiene exactamente 100 bytes. |
language:LANGUAGE | display language:scss coincide con el código con la palabra "display", que se marca como SCSS. |
language:LANGUAGE | org:mozilla language:Markdown coincide con el código de todos los repositorios de @mozilla marcados como Markdown. |
Buscar por tamaño de archivo
Puede utilizar el calificador size
para buscar código fuente en base al tamaño del archivo donde existe el código. El calificador size
usa calificadores mayor que, menor que y de rango para filtrar los resultados en función del tamaño en bytes del archivo en el que se encuentra el código.
Calificador: | Ejemplo |
---|---|
size:n | function size:>10000 language:python coincide con el código con la palabra "function", escrita en Python, en archivos que tienen más de 10 KB. |
Buscar por nombre de archivo
El calificador filename
coincide con archivos de código con un determinado nombre de archivo. También puedes encontrar un archivo en un repositorio utilizando el buscador de archivo. Para más información, consulta Buscar archivos en GitHub.
Calificador: | Ejemplo |
---|---|
filename:FILENAME | filename:linguist coincide con los archivos denominados "linguist". |
filename:FILENAME | los comandos filename:.vimrc coinciden con los archivos .vimrc con la palabra "commands". |
filename:FILENAME | filename:test_helper path:test language:ruby coincide con los archivos Ruby denominados test_helper en el directorio de prueba. |
Buscar por extensión de archivo
El calificador extension
coincide con archivos de código con una determinada extensión de archivo.
Calificador: | Ejemplo |
---|---|
extension:EXTENSION | form path:cgi-bin extension:pm coincide con el código con la palabra "form", en cgi-bin, con la extensión de archivo .pm. |
extension:EXTENSION | icon size:>200000 extension:css coincide con los archivos de más de 200 KB que terminan en .css y tienen la palabra "icon". |