首页/开发/Git 与协作速查/git archive 导出发布包
Git 基础与命令88 条

git archive 导出发布包

把指定版本打包为 tar/zip:不含 .git 目录,--prefix 添加顶层目录,.gitattributes 中 export-ignore 的路径会被排除。

Git 与协作速查开发更新于 2026-10-12
用途生成发布包或交付物
格式tar / tar.gz / zip(按 --format 或扩展名)
顶层目录--prefix=app/ 避免解压污染当前目录

常用示例

常用示例
git archive --format=tar.gz -o app-1.2.0.tgz v1.2.0
git archive --format=zip --prefix=app/ HEAD > app.zip
git archive v1.2.0 | tar -t | head
用标签而不是工作区导出,构建产物与发布点一一对应,可复现。

易错点

  • archive 不含子模块内容,交付需要子模块时另行处理
  • 默认只导出单个提交引用的内容,未提交改动不会出现

数据来源与参考

  • Git 官方文档:git-archive
  • Git 官方文档:gitattributes(export-ignore)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌