Plugin Buscar en archivos¶
Busca en todos los archivos de una carpeta del disco y salta directamente a cada coincidencia, para encontrar todos los sitios donde aparece un término en un proyecto. La búsqueda se ejecuta en segundo plano, así que el editor sigue respondiendo en árboles grandes.
Dónde encontrarlo¶
Buscar ▸ Buscar en archivos… — atajo Ctrl+Shift+F.
El diálogo¶
| Campo / opción | Significado |
|---|---|
| Buscar | El término que se busca (con historial de consultas recientes). |
| Buscar en | El ámbito: Carpeta o Documentos abiertos (ver más abajo). |
| Filtros | Globs de nombre de archivo que incluir, p. ej. *.cpp *.h o *.txt. Vacío significa todos los archivos. (Los filtros recientes se recuerdan.) Solo en el ámbito Carpeta. |
| Directorio | La carpeta en la que buscar; Examinar… elige una. Los directorios recientes se recuerdan. Solo en el ámbito Carpeta. |
| En todas las subcarpetas | Entra en los subdirectorios (activado de forma predeterminada). Solo en el ámbito Carpeta. |
| Distinguir mayúsculas y minúsculas | Búsqueda sensible a la caja. |
| Solo palabras completas | Coincide solo con palabras enteras. |
| Modo de búsqueda | Normal (literal), Extendido (descodifica \n, \t, \r, \0, \xNN) o Expresión regular (regex ECMAScript). |
Ámbito de búsqueda¶
Los dos ámbitos son deliberadamente disjuntos: un resultado procede siempre de exactamente uno de ellos.
| Ámbito | Qué se busca |
|---|---|
| Carpeta | Los archivos del disco bajo Directorio (respetando Filtros y En todas las subcarpetas). Las pestañas abiertas que viven fuera de esa carpeta no se incluyen, y las ediciones sin guardar no se ven: esto es un barrido del disco. |
| Documentos abiertos | Los búferes en vivo de todas las pestañas abiertas, incluidas las sin título y las ediciones sin guardar. Los filtros y el directorio se ignoran. |
Carpeta es el valor predeterminado mientras hay una carpeta de espacio de trabajo abierta (Archivo ▸ Abrir carpeta); Documentos abiertos lo es en caso contrario. Carpeta sigue disponible siempre que se conozca un directorio (la carpeta del archivo activo, una recordada o una que elijas con Examinar…), así que Buscar todo siempre busca en algo: nunca se queda sin hacer nada en silencio.
Resultados¶
Las coincidencias se acumulan en un panel acoplable de Resultados a medida que se encuentran, agrupadas por archivo con el número de línea y el texto coincidente. Haz doble clic en una coincidencia para abrir ese archivo y saltar a la línea y la columna exactas; una coincidencia del ámbito Documentos abiertos activa su pestaña (con las ediciones que produjeron la coincidencia intactas) en lugar de recargar el archivo desde el disco.
El encabezado del panel tiene un botón Detener mientras hay una búsqueda en marcha. Cerrar el diálogo no interrumpe una búsqueda en curso: el panel de Resultados es su dueño.
Cómo hace el barrido
Un hilo en segundo plano recorre el directorio elegido (entrando en los subdirectorios si procede) y lee cada archivo que pasa el filtro. Las coincidencias llegan al panel por lotes y el recorredor espera cuando el panel se queda atrás, de modo que un árbol enorme mantiene la interfaz reactiva. Una búsqueda se detiene tras 20 000 coincidencias con «Resultados truncados en 20000 coincidencias: acota el filtro»; ese es un tope de líneas coincidentes, no de archivos examinados. El ámbito Documentos abiertos trabaja sobre búferes en memoria y no necesita hilo.