Git Archive
一句话解释
git archive 把树(提交、分支或路径)导出为 tar 或 zip 文件,不含 .git 目录。
用大白话说
git archive 创建一个 Git 树——提交、分支、标签或路径——的 tar 或 zip 归档,不含 .git 目录或历史。它是在特定点导出仓库干净快照的方式,适合分发、部署或交给不需要历史的人。用 --format=tar 或 --format=zip 指定格式,-o 指定输出文件,再给 tree-ish(提交/分支/标签)与可选路径。归档含该版本的工作树内容,并遵循 .gitattributes 的 export-ignore 规则排除不想发布的文件。适用场景:创建发布 tarball(git archive v1.0 -o release-1.0.zip)、把特定提交部署到服务器而无需克隆、给贡献者一个起始快照。比克隆再删 .git 更快更干净。
示例
bash
# Export the main branch as a zip
git archive --format=zip -o project.zip main
# Export a specific tag as a tarball
git archive --format=tar -o release-1.0.tar v1.0
# Export only a subdirectory
git archive --format=zip -o web.zip main:packages/web
# Pipe to gzip for a .tar.gz
git archive --format=tar v1.0 | gzip > release-1.0.tar.gzarchive 把树打包为 tar/zip,不含 .git 或历史。:path 限定子目录。.gitattributes 的 export-ignore 排除标记文件。
相关术语
相关资源
相关课程
- Git 进阶
学习 git archive。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。