Skip to content

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.gz

archive 把树打包为 tar/zip,不含 .git 或历史。:path 限定子目录。.gitattributes 的 export-ignore 排除标记文件。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表