Skip to main content

Sobre a Pesquisa de Código do GitHub

Você pode pesquisar, navegar e entender o código em GitHub com a Pesquisa de Código.

Sobre a Pesquisa de Código do GitHub

A pesquisa de código do GitHub permite pesquisar, navegar e entender rapidamente seu código, o código de sua equipe e o código da comunidade de código aberto. Esse mecanismo de pesquisa foi projetado para ser escalonável, oferecer reconhecimento de código e dar suporte à Pesquisa de Código no GitHub por meio de expressões regulares, operações boolianas, qualificadores especializados e pesquisas de símbolos. Para obter mais informações sobre a sintaxe da Pesquisa de Código, confira "Entender a sintaxe de pesquisa de código do GitHub".

A pesquisa de Código está integrada aos recursos na interface de pesquisa no GitHub, como sugestões e conclusões. Suas pesquisas serão salvas automaticamente e podem ser excluídas a qualquer momento. Em GitHub Mobile, você pode usar os mesmos métodos para pesquisar o código diretamente da tela inicial. Para obter mais informações, confira "Usar a Pesquisa de Código do GitHub".

Você deve estar conectado a uma conta GitHub para usar a pesquisa de código, inclusive para pesquisar código em repositórios públicos.

Observe que a sintaxe e os qualificadores para pesquisar conteúdos não relacionados ao código, como problemas, usuários e discussões, não é igual à sintaxe para pesquisa de código. Para obter mais informações sobre a pesquisa sem código, confira "Sobre a pesquisa no GitHub" e "Pesquisar no GitHub".

Navegação de código

A pesquisa de código GitHub fornece navegação de código para linguagens compatíveis. Isso inclui ir para a definição e encontrar referências para construções de linguagem de programação, como classes, structs, funções e métodos. Confira "Navegar por códigos no GitHub".

As linguagens compatíveis para navegação de código incluem:

  • Bash
  • C
  • C#
  • C++
  • CodeQL
  • Elixir
  • Go
  • JSX
  • Java
  • JavaScript
  • Lua
  • PHP
  • Buffers de protocolo
  • Python
  • R
  • Ruby
  • Rust
  • Scala
  • Starlark
  • Swift
  • TypeScript

Limitações

Muitos repositórios públicos já foram indexados para a Pesquisa de Código e outros serão em breve. Além disso, os repositórios privados de usuários do GitHub são indexados e podem ser pesquisados por aqueles que já têm acesso a esses repositórios privados no GitHub. No entanto, é possível que repositórios muito grandes ainda não estejam indexados no momento, assim como o código completo.

As limitações atuais em códigos indexados são as seguintes:

  • Códigos gerados e de fornecedores são excluídos
  • Arquivos vazios e arquivos com mais de 350 KiB são excluídos
  • Linhas com mais de 1.024 caracteres são truncadas
  • Arquivos binários (PDF etc.) são excluídos
  • Apenas arquivos codificados em UTF-8 são incluídos
  • Repositórios muito grandes podem não ser indexados
  • Não há suporte para pesquisa exaustiva
  • Arquivos com mais de uma linha acima de 4.096 bytes são excluídos

Atualmente, só há suporte à Pesquisa de Código no branch padrão de um repositório. O comprimento da consulta é limitado a 1.000 caracteres.

Os resultados de qualquer pesquisa com a Pesquisa de Código são restritos a 100 ocorrências (5 páginas). No momento, não há suporte para a classificação dos resultados da Pesquisa de Código. Essa limitação só vale para pesquisar código com a nova Pesquisa de Código, não para outros tipos de pesquisas.

Se você usar o qualificador path: para um arquivo que está em vários repositórios com conteúdo semelhante, GitHub mostrará apenas alguns desses arquivos. Se isso acontecer, você poderá optar por expandir clicando em Mostrar arquivos idênticos na parte inferior da página.

A Pesquisa de Código dá suporte à pesquisa de definições de símbolo no código, como definições de função ou classe, por meio do qualificador symbol:. No entanto, observe que o qualificador symbol: procura apenas definições, não referências, e que nem todos os tipos de símbolos ou linguagens têm suporte completo no momento. Para obter uma lista das linguagens compatíveis, confira "Entender a sintaxe de pesquisa de código do GitHub".

Em GitHub Mobile, você pode usar a pesquisa de código diretamente da tela inicial. Para obter mais informações, confira "Usar a Pesquisa de Código do GitHub".

Feedback e suporte

É possível exibir e compartilhar feedback sobre a Pesquisa de Código no fórum de discussão.