---
id: "arquivos-buscar"
titulo: "Buscar arquivos e conteúdo"
resumo: "Filtrar por nome, buscar dentro dos arquivos com opções de maiúsculas, palavra inteira e regex, limitar por pasta e abrir pela paleta."
idioma: "pt-br"
tipo: "guia"
categoria: "arquivos-git"
aplicavelDesde: "0.0.16"
capabilities: ["search.name.filter", "search.content", "fileTree.findInFolder", "search.quickOpen"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/pt-br/ferramentas/arquivos/buscar/"
fonte: "pt-br/ferramentas/arquivos/buscar.md"
caminhoPublico: "docs/publica/pt-br/ferramentas/arquivos/buscar.md"
hashFonte: "sha256:c44ee87b6bf39c4286b63b1c991e31179e716ffe4005ec6a6746b7963de44886"
hashDestaPagina: "sha256:c44ee87b6bf39c4286b63b1c991e31179e716ffe4005ec6a6746b7963de44886"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
## Três buscas, três alcances

| Busca | Onde procura | Onde fica |
|---|---|---|
| **Filtrar por nome** | Nomes de arquivo e pasta da árvore | Campo de busca do painel Arquivos, no alcance de nomes |
| **Buscar no conteúdo** | Texto dentro dos arquivos do workspace | O mesmo campo, no alcance de conteúdo |
| **Ir para arquivo** | Nomes do worktree, com ranking | Paleta própria, por atalho |

O campo de busca é **único** e alterna entre os dois alcances. **A consulta sobrevive à troca de alcance** — trocar de "nome" para "conteúdo" não apaga o que você digitou.

## Filtrar por nome

- A árvore é filtrada pelos nomes, com os caminhos recolhidos para mostrar o que casou.
- Com o campo vazio, **a própria árvore é a resposta**: nada é escondido.
- Consultas muito grandes são limitadas.

## Buscar no conteúdo

No alcance de conteúdo, a busca varre o texto dos arquivos do workspace.

Opções do campo:

- **Maiúsculas e minúsculas** — diferenciação exata.
- **Palavra inteira** — evita casar dentro de outra palavra.
- **Expressão regular** — para padrões.
- **Incluir** e **excluir** — restringem os arquivos varridos por padrão de caminho.

Como o resultado aparece:

- A lista mostra **um grupo por arquivo**, com as linhas que casaram.
- O rodapé resume o resultado.
- Resultados só aparecem com o alcance de conteúdo e uma consulta não vazia.
- Conjuntos muito grandes de resultado têm limite de renderização — é o que evita travar a lista.

## Buscar numa pasta específica

No menu de contexto de uma pasta, a ação **buscar nesta pasta**:

- grava um **padrão de inclusão** com aquela pasta;
- muda o alcance para **conteúdo**;
- revela os campos de padrão, para você ver e ajustar o filtro.

> Se a lista de resultados parecer recortada sem motivo, **confira os campos de padrão**: o filtro de pasta pode estar ativo.

## Ir para arquivo

A paleta **ir para arquivo** é o caminho mais rápido quando você sabe o nome:

1. Abra a paleta pelo atalho.
2. Digite parte do nome.
3. Escolha o resultado — o arquivo abre **para edição**.

- A lista é dos arquivos do **worktree ativo**.
- A paleta depende de uma ferramenta de busca de arquivos no sistema. **Se ela faltar, aparece orientação de instalação em vez de lista** — o erro é do ambiente, não do seu projeto.

## Qual usar

| Situação | Busca |
|---|---|
| Você sabe o nome | Ir para arquivo |
| Você quer ver onde um nome aparece na árvore | Filtrar por nome |
| Você procura onde um texto está no código | Buscar no conteúdo |
| Você quer restringir a uma pasta | Buscar nesta pasta + buscar no conteúdo |

## Limites

- A busca de conteúdo lê arquivos do workspace; o que está no `.gitignore` depende do que a árvore está mostrando.
- Não há promessa de busca sem limite em repositórios muito grandes: há limite de renderização na lista de resultados.
- A paleta depende de ferramenta externa presente no sistema.

## Relacionados

- [A árvore e o status do git](/docs/pt-br/ferramentas/arquivos/arvore-e-status/)
- [O editor](/docs/pt-br/ferramentas/arquivos/editor/)