Symbole @ de Cursor
Dans Cursor,@Le symbole est un outil puissant pour accéder et référencer rapidement diverses informations contextuelles, aidant les utilisateurs à interagir avec l'IA plus efficacement.
Dans n'importe quel scénario d'interaction avec l'IA (tel que⌘KSaisissez-le dans la palette de commandes, la fenêtre de chat ou le terminal)@, cela déclenchera un menu lié au contexte, filtrant et recommandant automatiquement les ressources les plus pertinentes du projet en cours (comme des fichiers, des extraits de code, des documents, etc.).
Opérations au clavier : utilisez↑/↓Utilisez les touches fléchées pour naviguer, Entrée pour confirmer la sélection. Si l'élément sélectionné est une catégorie (par exemple,@Files), la liste filtrera plus précisément les ressources spécifiques de cette catégorie.
Stratégie de lecture de fichiers : pour les références de fichiers, vous pouvezCtrl/⌘ Mbasculer entre les modes « lecture complète » et « lecture résumée » (par exemple, référence en texte intégral ou uniquement les parties clés).
Symbole @
@Le symbole prend en charge les principales commandes suivantes :
| Fonctionnalités | Description | Cas d'utilisation |
|---|---|---|
| @Files | Référencer le fichier entier comme contexte. Prend en charge l'aperçu du chemin de fichier et le traitement par blocs. | Lorsque vous devez référencer un contenu de fichier spécifique, comme des fichiers de code, des documents, etc. |
| @Folders | Référencer un dossier entier comme contexte. | Utilisé lorsqu'un grand nombre de fichiers doit être fourni comme contexte, comme un répertoire de projet. |
| @Code | Référencer un extrait de code spécifique comme contexte. | Lorsque vous devez interroger ou manipuler des extraits de code spécifiques. |
| @Codebase | Recherchez les fichiers ou blocs de code importants dans la base de code et réorganisez-les par pertinence. | Utilisé lorsque vous devez trouver du code ou des fichiers pertinents dans l'ensemble de la base de code. |
| @Git | Analysez les commits, diffs ou pull requests Git pour aider à trouver des problèmes. | Utilisé lorsque vous devez analyser des informations liées à Git, telles que l'historique des commits, les diffs de code, etc. |
| @Web | Recherchez des informations web comme contexte supplémentaire. | Utilisé lorsque vous devez obtenir les dernières informations web ou des ressources externes. |
| @Docs | Référencez la documentation tierce prédéfinie ou une documentation personnalisée. Prend en charge l'ajout de documentation personnalisée. | Lorsque vous devez référencer des documents externes ou une base de connaissances personnalisée. |
| @Definitions | Référencez toutes les définitions proches comme contexte. | Lorsque vous devez référencer des définitions telles que des variables et des fonctions dans le code actuel. |
| @Chat | Ajoutez le message de chat actuel comme contexte. | Lorsque vous devez référencer le contenu d'une conversation précédente dans le chat. |
Conseils d'utilisation avancée
Commandes combinées :Saisie@Files src/utils/helper.js @Codebase, vous pouvez référencer le fichier spécifié et associer le contexte global de la base de code pour générer du code hautement personnalisé.
Intégration dynamique des ressources :Collez au début@pour les liens (par exemple, @https://api.example.com/docs), Cursor analysera automatiquement le contenu et l'inclura dans le contexte.
Gestion de la confidentialité et de la configuration :Via.cursorignoreUn fichier (comme .gitignore) exclut les fichiers ou répertoires sensibles de l'indexation. Ajoutez des liens de documentation personnalisés dans Paramètres > Fonctionnalités > Docs pour améliorer@DocsPortée de couverture.
Exemples de cas d'utilisation typiques
1. Génération de code
- Instruction : Générer la fonctionnalité de connexion utilisateur@Files src/models/user.js @Docs https://jwt.io/introduction
- Résultat : Générer une logique d'authentification sécurisée basée sur le modèle utilisateur existant et la documentation officielle JWT.
2. Dépannage des erreurs
- Commande : Expliquer la cause de cette erreur@Code 12-25ligne@Git HEAD~1
- Résultat : Analyser les problèmes potentiels en combinant l'extrait de code et l'historique récent des commits.
3. Refactorisation inter-fichiers
- Commande : Convertir les composants de classe en composants fonctionnels@Folders src/components @Codebase
- Résultat : Convertir par lots et garantir la compatibilité avec les styles globaux et la gestion d'état.