À quoi sert le fichier .git/index.lock ?

Quand Git modifie l'index (la zone de staging), il écrit d'abord la nouvelle version dans index.lock, puis la renomme atomiquement en index. Ce verrou garantit qu'un seul processus modifie la zone de staging à la fois et évite toute corruption. En temps normal, il n'existe qu'une fraction de seconde.

Est-ce risqué de supprimer .git/index.lock ?

Non, tant qu'aucun processus Git ne tourne réellement. Le fichier contient une copie temporaire de l'index, pas ton travail. Tes commits, branches et fichiers ne sont pas touchés. Supprime-le seulement après avoir vérifié que rien de lié à Git n'est actif, sinon tu pourrais interrompre une vraie opération.

Pourquoi ça revient tout le temps avec mon IDE ?

Les IDE et clients graphiques (VS Code, IntelliJ, SourceTree, GitKraken) lancent Git en arrière-plan pour rafraîchir le statut, faire de l'auto-fetch ou du staging. Si tu lances une commande dans le terminal au même moment, les deux entrent en collision. Désactive les rafraîchissements agressifs, ou laisse un outil finir avant d'utiliser l'autre.

Le fichier revient juste après suppression. Que faire ?

Quelque chose le recrée activement : en général un IDE, un watcher de fichiers ou un hook qui lance Git en boucle. Ferme l'IDE et les outils en arrière-plan, supprime le verrou une nouvelle fois et lance ta commande. Sur un lecteur réseau ou un dossier synchronisé (Dropbox, OneDrive), déplace le dépôt sur un disque local : les outils de sync sont une cause classique.

Télécharger

fatal: Unable to create '.git/index.lock': File exists

Cette erreur signifie qu'un autre processus Git détient le verrou sur ta zone de staging, ou qu'un processus planté a laissé le fichier derrière lui. Rien n'est corrompu et aucun travail n'est perdu. Voici comment débloquer proprement.

Apprendre Git en pratiquant Voir la solution

gitquest — enquête

Explication de l'erreur

Ce que cette erreur signifie

Chaque fois que Git met à jour l'index (ta zone de staging), il crée .git/index.lock comme verrou exclusif, fait ses modifications, puis le supprime. Si le fichier existe déjà au lancement d'une commande, Git refuse d'agir : soit un autre processus travaille vraiment, soit un processus précédent est mort avant de nettoyer.

gitquest terminal : index.lock existe

$git commit -m "Ajoute l'écran de connexion"

fatal: Unable to create '/Users/toi/projet/.git/index.lock': File exists.

Another git process seems to be running in this repository, e.g.

an editor opened by 'git commit'. Please make sure all processes

are terminated then try again. If it still fails, a git process

may have crashed in this repository earlier:

remove the file manually to continue.

Causes principales

Pourquoi cela se produit

Deux processus Git en même temps

Tu as lancé une commande pendant qu'une autre travaillait encore : un commit qui attend son éditeur de message, un gros rebase, ou un second terminal sur le même dépôt.

IDE ou client graphique en arrière-plan

VS Code, IntelliJ, SourceTree et compagnie lancent Git en permanence pour les rafraîchissements et l'auto-fetch. Leurs opérations peuvent entrer en collision avec tes commandes dans le terminal.

Un processus qui a planté

Git a été tué en pleine opération (crash, terminal fermé, redémarrage, disque plein) et n'a jamais supprimé son verrou. Le fichier reste là et bloque tout.

Solution étape par étape

Comment corriger

Règle numéro un : ne supprime jamais le verrou pendant que Git tourne vraiment. Vérifie d'abord, supprime ensuite.

Vérifier les processus en cours

Un éditeur qui attend un message de commit ou un IDE en pleine opération est le coupable le plus fréquent. Termine ou ferme-les d'abord.

gitquest terminal : vérifier les processus

# 1. Vérifie si un processus Git tourne encore

$ps aux | grep git

# Vérifie aussi : un éditeur attend-il un message de commit ?

# Ton IDE (VS Code, IntelliJ) fait-il une opération Git ?

# Si oui : termine ou ferme, puis relance ta commande

Supprimer le verrou orphelin

Si rien ne tourne, le verrou est un résidu. Le supprimer est sans danger et ne perd rien.

gitquest terminal : supprimer et relancer

# 2. Aucun processus Git ? Le verrou est orphelin. Supprime-le.

$rm .git/index.lock

# Sous Windows (cmd) : del .git\index.lock

# 3. Relance ta commande

$git commit -m "Ajoute l'écran de connexion"

[main f2e9a1b] Ajoute l'écran de connexion

Bonnes pratiques

Comment éviter cette erreur

Une opération Git à la fois

Laisse chaque commande se terminer avant d'en lancer une autre, surtout entre ton terminal et l'intégration Git de ton IDE.

Garde tes dépôts sur un disque local

Les dépôts dans Dropbox, OneDrive ou sur un partage réseau sont une source classique de conflits de verrou : l'outil de sync touche les fichiers pendant que Git travaille. Synchronise ton code avec des remotes Git à la place.

Ne tue pas Git en pleine opération

Évite de fermer le terminal ou de faire Ctrl+C pendant un commit, un rebase ou un merge. Si une commande semble bloquée, vérifie si elle a ouvert un éditeur et t'attend simplement.

Commandes associées

git commit

Enregistrer tes modifications indexées

git add

Indexer des modifications dans le staging

git status

Inspecter l'état de ton dépôt

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 index.lock

Comprends ce que Git fait sous le capot

Index, zone de staging, fichiers de verrou : GitQuest rend les entrailles de Git limpides grâce à des enquêtes pratiques dans un simulateur de terminal sécurisé.

Commencer à pratiquer