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ón | Descripción | Escenario de uso |
|---|---|---|
| @Files | Hace 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. |
| @Folders | Hace referencia a toda la carpeta como contexto. | Cuando se necesita proporcionar muchos archivos como contexto, por ejemplo, el directorio del proyecto. |
| @Code | Hace 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. |
| @Codebase | Busca 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. |
| @Git | Escanea 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. |
| @Web | Busca información en la web como contexto adicional. | Cuando se necesita obtener la información web más reciente o recursos externos. |
| @Docs | Hace 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. |
| @Definitions | Hace referencia a todas las definiciones cercanas como contexto. | Cuando se necesita hacer referencia a definiciones de variables, funciones, etc., en el código actual. |
| @Chat | Agrega 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.