Lectura y comprensión

Busca archivos, sigue símbolos y comprueba referencias al código

Cuándo usar Go to File, Search All Files o la navegación del servidor de lenguaje, y qué comprobar si falta un resultado.

Usa Go to File cuando sepas aproximadamente dónde está algo, Search All Files cuando sepas qué dice y la navegación del servidor de lenguaje para seguir un símbolo. Alternar entre las tres opciones suele ser más rápido que refinar una búsqueda demasiado amplia.

Elige la búsqueda adecuada

Qué sabes Qué usar Ejemplo
Parte del nombre o la ruta de un archivo Command-P (Go to File…) SettingsStore o src/config
Un mensaje, ajuste o fragmento de código Search All Files en la barra lateral Un mensaje de error exacto o clave de configuración
Un símbolo en un archivo abierto Go to Definition, Find References Implementación o llamadores de una función

Go to File busca nombres y rutas, no el contenido de los archivos. Para encontrar un mensaje que imprime el programa, usa Search All Files y busca algo distintivo en lugar de palabras como data o result.

Si falta un archivo o resultado, comprueba primero la raíz del proyecto y después si se muestran los archivos ocultos e ignorados por Git. Los valores por defecto están en Settings → General → Files y se aplican a la barra lateral, Go to File y Search All Files. Cada espacio de trabajo puede modificarlos desde la barra de estado lateral.

Sigue un mensaje de error hasta la rama que lo produjo

Un mensaje de error ofrece un punto de partida, pero la línea que lo imprime puede limitarse a envolver un fallo de otro lugar.

  1. Busca la parte fija. Abre Search All Files desde la lupa de la barra lateral. Omite marcas de tiempo, identificadores de solicitud y rutas insertadas durante la ejecución. Empieza con Regex y Whole word desactivados; si no sabes las mayúsculas exactas, elige Ignore en el menú Aa.
  2. Comprueba el alcance. Abre Filters y borra patrones antiguos de carpetas o archivos antes de buscar ampliamente. Cuando conozcas el módulo probable, limita la carpeta o usa un patrón como *.rs. La etiqueta Best matches indica que la lista está incompleta: refina la búsqueda antes de sacar conclusiones por la ausencia de coincidencias.
  3. Lee alrededor de la coincidencia. Abre el resultado y busca la condición que permite llegar a él. ¿Se crea aquí el mensaje o es una capa de captura o registro que añade contexto a otro error? En el segundo caso, sigue la operación que falló.
  4. Rastrea la entrada hacia atrás. Sigue las llamadas a la función contenedora y el valor que selecciona esta rama. Usa Find References si lo admite un servidor de lenguaje, o busca los nombres de la función y la configuración y examina cada uso en contexto.
  5. Comprueba la explicación. Compara la entrada y la rama propuestas con una prueba concreta existente o un registro de ejecución de la misma versión del código. Anota qué confirma esa evidencia y qué sigue pendiente; encontrar el mensaje no demuestra por sí solo la causa.

Search All Files busca en el espacio de trabajo actual, incluido el texto sin guardar de archivos abiertos. No busca en todas las revisiones de Git. Si el error procede de una compilación antigua, compara la versión correspondiente antes de considerar que el código actual lo explica.

Servidores de lenguaje

Go to Definition, Find References, implementaciones y jerarquía de llamadas dependen de un servidor de lenguaje:

Lenguaje Servidor
Swift SourceKit-LSP
Rust rust-analyzer
C, C++, Objective-C, Objective-C++ clangd
Python Pyright
JavaScript, JSX, TypeScript, TSX TypeScript Language Server
Go gopls

Yenpo puede instalar rust-analyzer desde Settings → Code Navigation. SourceKit-LSP y clangd vienen con la cadena de herramientas de Xcode seleccionada. Debes instalar Pyright, TypeScript Language Server y gopls y dejarlos disponibles en tu PATH. Las capacidades varían y algunos proyectos requieren configuración adicional para navegar.

Si un símbolo que sabes que existe no devuelve resultados, comprueba tres cosas: que abriste la raíz, que el servidor está instalado y que están disponibles las dependencias y la configuración de compilación. El resaltado de sintaxis funciona incluso sin servidor de lenguaje.

Sin servidor, la búsqueda de texto sigue siendo útil. Busca la declaración y sus usos; distingue símbolos homónimos mediante tipos e importaciones.

Sigue un comportamiento sin perder tu lugar

Mantén el archivo inicial abierto en una pestaña mientras sigues una definición en otra ubicación. En cada llamada importante, anota la entrada y qué decide el siguiente recorrido: un ajuste, un tipo, una clave de registro o el estado actual.

Find References muestra usos indicados por el servidor, no una traza de ejecución. El soporte del servidor, la configuración y los límites de resultados pueden dejar la lista incompleta. Si un registro tiene implementaciones local y remota, encuentra el valor que elige una. En código asíncrono, comprueba también qué puede cambiar antes de recibir el resultado.

Una nota de lectura de un valor de configuración podría ser así:

CLI input → config resolver → validation → request builder
Selected source: environment override
Failure: invalid value stops before request construction
Unverified: which parent process sets that environment variable

Añade referencias de archivo y línea para los pasos que comprobaste. El recorrido de configuración lo hace de principio a fin con pruebas ejecutables.

Comprueba una referencia de IA

Al pulsar una referencia de una respuesta de IA, se abren las líneas citadas en Quick Look. Si el fragmento no basta, pulsa Open File para abrir el archivo completo en una pestaña.

Lee las condiciones circundantes y el código que llama antes de confiar en la respuesta. Por ejemplo, una línea que elimina una entrada de caché puede ser segura solo si aún pertenece a la misma solicitud. La referencia indica dónde mirar; el código cercano permite comprobar la afirmación.

Documentación y versiones anteriores

Los archivos Markdown se abren en modo de lectura y puedes pasar a editar el código fuente. Mantén README o una prueba junto a la implementación y anota las discrepancias.

Los archivos del historial de Git pueden aparecer junto a los actuales. Antes de seguir una referencia o editar, comprueba qué versión muestra la pestaña: la explicación de un commit antiguo puede no coincidir con tu árbol de trabajo. Compara commits y ramas explica cómo elegir versiones.