Aller au contenu principal

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.

GitQuest
Démo

Par Anaïs Sparesotto, développeuse web et responsable pédagogique · Mis à jour le

Nettoyage

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 fichier

Supprimer du dépôt et du disque

git rm --cached fichier

Retirer 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é

A

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.