---
id: "arquivos-buscar"
titulo: "Buscar archivos y contenido"
resumo: "Filtrar por nombre, buscar dentro de los archivos con opciones de mayúsculas, palabra completa y regex, limitar por carpeta y abrir por la paleta."
idioma: "es"
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/es/ferramentas/arquivos/buscar/"
fonte: "pt-br/ferramentas/arquivos/buscar.md"
caminhoPublico: "docs/publica/es/ferramentas/arquivos/buscar.md"
hashFonte: "sha256:c44ee87b6bf39c4286b63b1c991e31179e716ffe4005ec6a6746b7963de44886"
hashDestaPagina: "sha256:0aeead552e10f307beeb9a6c4f518dd5a67cbfb264ebbd355b5ca9b101b5456a"
traducaoAssistidaPorIA: true
traducaoDesatualizada: false
corpoRetido: false
---
<!-- traducao-assistida-por-ia: idioma=ES fonte=pt-br/ferramentas/arquivos/buscar.md fonteHash=sha256:c44ee87b6bf39c4286b63b1c991e31179e716ffe4005ec6a6746b7963de44886 estado=atual -->

## Tres búsquedas, tres alcances

| Búsqueda | Dónde busca | Dónde está |
|---|---|---|
| **Filtrar por nombre** | Nombres de archivo y carpeta del árbol | El campo de búsqueda del panel Archivos, en el alcance de nombres |
| **Buscar en el contenido** | Texto dentro de los archivos del workspace | El mismo campo, en el alcance de contenido |
| **Ir a archivo** | Los nombres del worktree, con ranking | Paleta propia, por atajo |

El campo de búsqueda es **único** y alterna entre los dos alcances. **La consulta sobrevive al cambio de alcance** — cambiar de "nombre" a "contenido" no borra lo que escribiste.

## Filtrar por nombre

- El árbol se filtra por los nombres, con las rutas contraídas para mostrar lo que coincidió.
- Con el campo vacío, **el propio árbol es la respuesta**: nada se esconde.
- Las consultas muy grandes están limitadas.

## Buscar en el contenido

En el alcance de contenido, la búsqueda recorre el texto de los archivos del workspace.

Opciones del campo:

- **Mayúsculas y minúsculas** — distinción exacta.
- **Palabra completa** — evita coincidir dentro de otra palabra.
- **Expresión regular** — para patrones.
- **Incluir** y **excluir** — restringen los archivos recorridos por patrón de ruta.

Cómo aparece el resultado:

- La lista muestra **un grupo por archivo**, con las líneas que coincidieron.
- El pie resume el resultado.
- Los resultados solo aparecen con el alcance de contenido y una consulta no vacía.
- Los conjuntos muy grandes de resultados tienen límite de renderización — es lo que evita congelar la lista.

## Buscar en una carpeta específica

En el menú de contexto de una carpeta, la acción **buscar en esta carpeta**:

- graba un **patrón de inclusión** con esa carpeta;
- cambia el alcance a **contenido**;
- revela los campos de patrón, para que veas y ajustes el filtro.

> Si la lista de resultados parece recortada sin motivo, **revisa los campos de patrón**: el filtro de carpeta puede estar activo.

## Ir a archivo

La paleta **ir a archivo** es el camino más rápido cuando sabes el nombre:

1. Abre la paleta por su atajo.
2. Escribe parte del nombre.
3. Elige el resultado — el archivo abre **para editar**.

- La lista es de los archivos del **worktree activo**.
- La paleta depende de una herramienta de búsqueda de archivos en el sistema. **Si falta, aparece orientación de instalación en lugar de lista** — el error es del entorno, no de tu proyecto.

## Cuál usar

| Situación | Búsqueda |
|---|---|
| Sabes el nombre | Ir a archivo |
| Quieres ver dónde aparece un nombre en el árbol | Filtrar por nombre |
| Buscas dónde está un texto en el código | Buscar en el contenido |
| Quieres restringir a una carpeta | Buscar en esta carpeta + buscar en el contenido |

## Límites

- La búsqueda de contenido lee archivos del workspace; lo que está en `.gitignore` depende de lo que el árbol esté mostrando.
- No hay promesa de búsqueda sin límite en repositorios muy grandes: hay límite de renderización en la lista de resultados.
- La paleta depende de que una herramienta externa esté presente en el sistema.

## Relacionados

- [El árbol y el estado de git](/docs/es/ferramentas/arquivos/arvore-e-status/)
- [El editor](/docs/es/ferramentas/arquivos/editor/)