Git archive : exporter ton projet proprement
git archive crée une archive (zip, tar) de ton projet sans le dossier .git. Idéal pour livrer du code, créer des releases ou partager sans l'historique.
Par Anaïs Sparesotto, développeuse web et responsable pédagogique · Mis à jour le
C'est quoi git archive ?
git archive crée une archive de ton projet à partir d'un commit, tag ou branche. L'archive contient tes fichiers sans le dossier .git.
C'est comme faire un colis de ton code : tu choisis la version à emballer et Git crée un zip ou tar propre, prêt à être livré ou partagé.
Syntaxe de git archive
git archive --format=zip -o f.zip HEADArchive ZIP du HEAD
git archive --format=tar.gz -o f.tar.gz v1.0Archive tar.gz d'un tag
git archive --prefix=projet/ HEADAvec un dossier racine dans l'archive
Git archive en pratique
Créer des archives zip et tar de ton projet.
Archive ZIP
Archive TAR et sous-dossier
git archive vs zip classique
git archive
Exclut automatiquement .git, respecte export-ignore, peut cibler un tag/commit spécifique.
zip classique
Inclut tout le dossier y compris .git, node_modules et les fichiers ignorés.
Erreurs courantes avec git archive
Inclure des fichiers sensibles
Si .env est dans le dépôt, il sera dans l'archive. Utilise .gitattributes avec export-ignore pour exclure les fichiers sensibles.
Oublier --prefix
Sans prefix, les fichiers sont à la racine de l'archive. Ajoute --prefix=nom-projet/ pour les mettre dans un dossier (n'oublie pas le / final).
Archiver des fichiers non commités
git archive ne prend que les fichiers commités. Les modifications non commitées ne seront pas dans l'archive. Commite ou stash avant.
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 archive
Livre ton code avec GitQuest
Apprends à créer des releases propres et livrer ton code avec confiance.