Modèle .gitignore Rust expliqué
Explique pourquoi Rust.gitignore ignore le répertoire target, les sauvegardes de rustfmt, les informations de débogage MSVC et les résultats de cargo-mutants, ainsi que le changement de recommandation sur le commit de Cargo.lock.
Rust.gitignore est un modèle court qui ne contient que les règles minimales nécessaires à un projet Cargo. La plupart des artefacts étant regroupés dans un unique target/, les règles sont peu nombreuses.
L'ancien modèle conseillait d'ignorer Cargo.lock pour les bibliothèques, mais cette règle a disparu du modèle actuel. En 2023, l'équipe Rust a modifié sa recommandation : commiter Cargo.lock est désormais la règle par défaut pour tous les projets, bibliothèques comprises.
Explication règle par règle
| Motif | Ce qui est ignoré et pourquoi |
|---|---|
targetdebug | Résultats de build CargoDossier où cargo build place les résultats de compilation, le cache de build incrémental et les dépendances compilées. Il peut atteindre plusieurs Go et se régénère entièrement. Sans / final, un fichier portant ce nom est lui aussi ignoré. |
**/*.rs.bk | Sauvegardes de rustfmtSauvegardes que rustfmt laisse avant de modifier un fichier. Le motif commence par **/ et correspond donc à toute profondeur. |
*.pdb | Informations de débogage MSVCBases de données de symboles de débogage créées lors d'un build avec la chaîne d'outils MSVC sous Windows. |
**/mutants.out*/ | Résultats des tests de mutationRépertoires de résultats créés par cargo-mutants (mutants.out, mutants.out.old). À cause du / final, le motif ne correspond qu'à des répertoires. |
rustc-ice-*.txt | Dumps d'erreurs internes du compilateurTrace de pile que rustc laisse dans le répertoire courant lorsqu'il rencontre une erreur interne du compilateur (ICE). Utile pour signaler un bug, mais inutile dans le dépôt. |
Points d'attention en pratique
- Commitez
Cargo.lock. Pour des builds reproductibles et des résultats de CI cohérents, la recommandation actuelle de Cargo est de le commiter aussi pour les bibliothèques. - Avec un workspace, un seul
target/est créé à la racine du workspace ; mais comme la règletargetn'a pas de barre oblique, il est ignoré où qu'il apparaisse. - Les réglages de RustRover et IntelliJ se traitent à part avec le modèle JetBrains. Les commentaires du modèle précisent d'ailleurs qu'ignorer tout
.idea/n'est pas recommandé.
Modèle d'origine
# Generated by Cargo# will have compiled files and executablesdebugtarget# These are backup files generated by rustfmt**/*.rs.bk# MSVC Windows builds of rustc generate these, which store debugging information*.pdb# Generated by cargo mutants# Contains mutation testing data**/mutants.out*/# rustc will dump stack traces when hitting an internal compiler error to PWDrustc-ice-*.txt# RustRover# JetBrains specific template is maintained in a separate JetBrains.gitignore that can# be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore# and can be added to the global gitignore or merged into this file. For a more nuclear# option (not recommended) you can uncomment the following to ignore the entire idea folder.#.idea/
Source des modèles : github/gitignore/Rust.gitignore @356fd7b (2026-09-11) · CC0-1.0