Résolution des problèmes de lecture de base de code
Si Cursor a des difficultés à lire votre base de code ou vos fichiers, suivez ce guide pour résoudre les problèmes courants.
Symptômes courants
- Cursor ne peut pas voir les fichiers du projet
- Les fonctionnalités d'IA ne fonctionnent pas avec la base de code
- L'arborescence des fichiers ne se met pas à jour
- La fonctionnalité de recherche ne fonctionne pas
Solutions rapides
1. Actualiser l'arborescence des fichiers
La solution la plus rapide est souvent d'actualiser votre arborescence de fichiers :
- Clic droit sur l'explorateur de fichiers
- Sélectionnez "Actualiser"
- Attendez que l'arborescence des fichiers se mette à jour
2. Vérifier les permissions des fichiers
- Windows
- macOS/Linux
- Clic droit sur votre dossier de projet
- Sélectionnez "Propriétés"
- Allez dans l'onglet "Sécurité"
- Assurez-vous que votre utilisateur a les permissions "Lecture" et "Écriture"
# Vérifier les permissions
ls -la /chemin/vers/projet
# Corriger les permissions si nécessaire
chmod -R u+rw /chemin/vers/projet
3. Vérifier .gitignore
et .cursorignore
Parfois, des fichiers sont intentionnellement ignorés. Vérifiez :
- Le contenu du fichier
.gitignore
- Le contenu du fichier
.cursorignore
- Supprimez les modèles qui ne devraient pas être ignorés
Solutions approfondies
Problèmes de surveillance du système de fichiers
Si Cursor ne détecte pas les changements de fichiers :
{
"files.watcherExclude": {
"**/node_modules/**": true,
"**/dist/**": true,
// Ajoutez d'autres répertoires que vous souhaitez exclure
}
}
Gestion des grandes bases de code
Pour les grandes bases de code :
-
Augmenter la limite de mémoire
.cursor/settings.json{
"files.maxMemoryForLargeFilesMB": 4096
} -
Optimiser la surveillance des fichiers
- Exclure les répertoires inutiles
- Utiliser les fonctionnalités de confiance de l'espace de travail
- Envisager d'utiliser le stockage de l'espace de travail
Problèmes d'intégration Git
Si les fonctionnalités liées à Git ne fonctionnent pas :
-
Vérifier l'installation de Git :
git --version
-
Vérifier la configuration de Git :
git config --list
-
Réinitialiser le cache Git :
git rm -r --cached .
git add .
Conseils de prévention
-
Structure de projet propre
- Organiser les fichiers de manière logique
- Utiliser un
.gitignore
approprié - Garder le répertoire racine propre
-
Maintenance régulière
- Vider régulièrement le cache de l'éditeur
- Mettre à jour Cursor fréquemment
- Surveiller les ressources système
-
Optimisation des performances
- Exclure les gros fichiers binaires
- Utiliser le stockage de l'espace de travail
- Implémenter des modèles d'ignorance appropriés
Dépannage avancé
Journalisation et diagnostics
Activer la journalisation détaillée :
- Ouvrir la palette de commandes (Ctrl/Cmd + Maj + P)
- Tapez "Developer: Set Log Level"
- Sélectionnez "Trace"
Réinitialisation du cache
Si les problèmes persistent :
- Fermez Cursor
- Supprimez les répertoires de cache :
- Windows :
%APPDATA%\Cursor\Cache
- macOS :
~/Library/Application Support/Cursor/Cache
- Linux :
~/.config/Cursor/Cache
- Windows :
- Redémarrez Cursor
Confiance de l'espace de travail
Configurer la confiance de l'espace de travail :
- Ouvrir la palette de commandes
- Rechercher "Workspace Trust"
- Configurer les paramètres de confiance pour votre projet
Quand contacter le support
Contactez le support Cursor si :
- Les problèmes persistent après avoir essayé toutes les solutions
- Vous rencontrez une perte de données
- Les performances se dégradent significativement
- Vous trouvez des problèmes de sécurité
Gardez vos journaux d'erreurs et informations système à portée de main lorsque vous contactez le support