Synopsis

git commit [-m <msg>] [-a] [--amend] [--no-verify] [-S]

Description

The git commit command takes everything currently in the staging area and creates a new commit object in the repository. A commit is an immutable snapshot containing a tree (the file contents), parent pointer(s), author and committer metadata, and a message. Commits are the unit of history in Git: branches are pointers to commits, merges produce commits with multiple parents, and tags label specific commits.

A good commit message has a short subject line (under 50 characters), a blank line, and an optional body explaining the why. Many teams use conventional commits or other prefix systems. The --amend option modifies the most recent commit, useful for fixing typos in the message or forgetting to stage a file — but never amend a commit that has already been pushed and shared.

Dans l'usage quotidien, git commit s'intègre étroitement avec les alias de shell, les plugins d'éditeur et l'intégration continue. Les utilisateurs avancés ajoutent souvent des alias combinant les flags qu'ils passent toujours, ou enveloppent la commande dans des scripts qui appliquent les conventions d'équipe. Le formatage de la sortie peut être personnalisé via la configuration Git — pretty formats, schémas de couleurs et comportement du pager sont tous ajustables. Quand quelque chose tourne mal, la première étape de diagnostic est généralement de relancer la commande avec GIT_TRACE=1 dans l'environnement, ce qui révèle les appels de plomberie sous-jacents. Pour les situations inhabituelles, la sortie --help (git commit --help) ouvre la page de manuel complète avec les détails de chaque option, y compris celles rarement utilisées dans les workflows ordinaires mais essentielles pour le débogage ou le scripting à grande échelle.

Comprendre comment git commit interagit avec le reste du modèle de données de Git — la base d'objets, l'index, les refs et l'arborescence de travail — est rentable. Chaque commande opère sur un sous-ensemble de ces pièces, et savoir laquelle elle touche aide à prédire les résultats et récupérer après les erreurs. Lire la documentation officielle de Git en parallèle de la pratique sur un dépôt jetable est la façon la plus rapide d'intérioriser les subtilités. La plupart des problèmes de production avec Git proviennent de l'une de trois causes : comportement par défaut surprenant, opérations réseau partielles, ou réécriture d'historique déjà partagé. Un modèle mental fonctionnel des effets de bord de git commit aide à éviter les trois.

Options courantes

Exemples

git commit -m "Fix off-by-one error in pagination"
# Commit rapide avec message d'une ligne

git commit -am "Update README"
# Stager les changements suivis et commiter en une étape

git commit --amend -m "Better message"
# Réécrire le message du commit le plus récent

git commit --fixup=abc123
# Créer un commit fixup à squasher pendant le rebase

Erreurs fréquentes

Amending a published commit and then force-pushing rewrites history that others may have based work on, causing confusion. Only amend local, unshared commits. Another mistake is committing with -a when untracked files should also be included — -a ignores new files. Finally, never use --no-verify just to bypass failing tests; fix the test or the code instead.

Commandes liées

git add, git status, git log, git revert