Git rm : supprimer des fichiers du dépôt
git rm supprime un fichier du dépôt Git. Avec --cached, il retire le fichier du suivi sans le supprimer du disque. Indispensable pour nettoyer ton projet.
Par Anaïs Sparesotto, développeuse web et responsable pédagogique · Mis à jour le
C'est quoi git rm ?
git rm supprime un fichier du dépôt Git. Contrairement à un simple rm, Git enregistre la suppression et la prépare pour le prochain commit.
Le cas d'usage le plus courant : retirer un fichier sensible (.env, credentials) ajouté par erreur avec git rm --cached.
Syntaxe de git rm
git rm fichierSupprimer du dépôt et du disque
git rm --cached fichierRetirer du suivi, garder sur le disque
git rm -r dossier/Supprimer un dossier récursivement
Git rm en pratique
Supprimer des fichiers ou retirer du suivi.
Supprimer un fichier
Retirer du suivi (--cached)
git rm vs rm vs .gitignore
git rm
Supprime du dépôt Git et du disque. La suppression est stagée.
git rm --cached
Retire du suivi Git mais garde le fichier sur le disque.
.gitignore
Empêche Git de suivre des fichiers pas encore trackés. N'affecte pas les fichiers déjà suivis.
Erreurs courantes avec git rm
Ajouter .env au .gitignore mais oublier git rm --cached
.gitignore n'affecte pas les fichiers déjà suivis. Il faut d'abord git rm --cached .env puis ajouter .env au .gitignore.
Utiliser rm au lieu de git rm
Si tu supprimes avec rm, Git voit la modification mais ne la stage pas. Tu dois ensuite faire git add pour stager la suppression.
Oublier que le fichier reste dans l'historique
git rm supprime le fichier du prochain commit, mais il existe toujours dans les commits précédents. Pour un secret, il faut réécrire l'historique.
Fait partie du guide Git avancé
GitQuest est conçu par Anaïs (nouvelle fenêtre), développeuse web et responsable pédagogique, spécialisée en formations tech et accessibilité numérique.
Questions sur git rm
Apprends à gérer tes fichiers avec GitQuest
Les enquêtes GitQuest t'apprennent à nettoyer et organiser ton dépôt.