Cursor @ símbolo

En Cursor,@el símbolo es una herramienta potente para acceder y hacer referencia rápidamente a información contextual diversa, ayudando a los usuarios a interactuar con la IA de forma más eficiente.

En cualquier escenario de interacción con IA (como⌘Kpanel de comandos, ventana de chat o terminal) al escribir@, se activa el menú contextual asociado, que filtra automáticamente y recomienda los recursos más relevantes del proyecto actual (como archivos, fragmentos de código, documentos, etc.).

  • Operación con teclado: use↑/↓las teclas de dirección para navegar y Enter para confirmar la selección. Si selecciona una categoría (como@Files), la lista filtrará aún más los recursos específicos de esa categoría.

  • Estrategia de lectura de archivos: para referencias de archivos, puedeCtrl/⌘ Malternar entre los modos "lectura completa" o "lectura resumida" (por ejemplo, citar todo el contenido o solo las partes clave).


@ símbolo

@El símbolo admite los siguientes comandos principales:

FunciónDescripciónEscenario de uso
@FilesHace referencia al archivo completo como contexto. Admite vista previa de la ruta del archivo y procesamiento por bloques.Cuando se necesita hacer referencia al contenido de un archivo específico, como archivos de código, documentos, etc.
@FoldersHace referencia a toda la carpeta como contexto.Cuando se necesita proporcionar muchos archivos como contexto, por ejemplo, el directorio del proyecto.
@CodeHace referencia a un fragmento de código específico como contexto.Cuando se necesita consultar u operar sobre un fragmento de código específico.
@CodebaseBusca archivos o bloques de código importantes en el repositorio y los reordena según su relevancia.Cuando se necesita buscar código o archivos relevantes en todo el repositorio.
@GitEscanea confirmaciones de Git, diferencias o solicitudes de extracción (pull requests) para ayudar a encontrar problemas.Cuando se necesita analizar información relacionada con Git, como registros de confirmación, diferencias de código, etc.
@WebBusca información en la web como contexto adicional.Cuando se necesita obtener la información web más reciente o recursos externos.
@DocsHace referencia a documentos de terceros predefinidos o documentos personalizados. Admite agregar documentos personalizados.Cuando se necesita hacer referencia a documentación externa o bases de conocimiento personalizadas.
@DefinitionsHace referencia a todas las definiciones cercanas como contexto.Cuando se necesita hacer referencia a definiciones de variables, funciones, etc., en el código actual.
@ChatAgrega el mensaje de chat actual como contexto.Cuando en el chat se necesita hacer referencia a conversaciones anteriores.

Técnicas avanzadas de uso

Combinación de comandos:Ingrese@Files src/utils/helper.js @Codebase, puede hacer referencia al archivo especificado y asociar el contexto global del repositorio para generar código altamente personalizado.

Integración dinámica de recursos:Pegue un enlace que comience con@(por ejemplo, @https://api.example.com/docs). Cursor analizará automáticamente el contenido y lo incluirá en el contexto.

Privacidad y administración de configuración:Mediante el archivo.cursorignore(similar a .gitignore) se excluyen archivos o directorios sensibles del índice. En Settings > Features > Docs, agregue enlaces de documentos personalizados para mejorar@Docsla cobertura de.

Ejemplos de escenarios de aplicación típicos

1. Generación de código

  • Instrucción: Generar función de inicio de sesión de usuario@Files src/models/user.js @Docs https://jwt.io/introduction
  • Resultado: Generar lógica de autenticación segura basada en el modelo de usuario existente y la documentación oficial de JWT.

2. Solución de problemas

  • Instrucción: Explicar la causa de este error@Code 12-25Línea@Git HEAD~1
  • Resultado: Analizar posibles problemas combinando el fragmento de código y el historial de confirmaciones recientes.

3. Refactorización entre archivos

  • Instrucción: Convertir componentes de clase en componentes funcionales@Folders src/components @Codebase
  • Resultado: Convertir por lotes y garantizar la compatibilidad de los estilos globales y la gestión de estado.
Otras extensiones