打包与归档

打包与归档的基本概念

Git中的打包与归档主要涉及将仓库内容转换为压缩格式或独立文件包。git archive命令是核心工具，它允许从特定提交或分支创建归档文件，支持多种格式如zip、tar.gz等。与常规压缩不同，Git归档会保留文件权限和Git元数据，适合代码分发或部署。

# 创建当前分支的zip归档
git archive --format=zip --output=project.zip HEAD

创建特定版本的归档

通过指定提交哈希、分支或标签，可以精确控制归档内容版本。这在持续集成环境中特别有用，比如需要将特定版本的代码交付给测试团队时：

# 归档v1.0.0标签内容为tar.gz
git archive --format=tar.gz v1.0.0 | gzip > release-v1.0.0.tar.gz

对于包含子模块的项目，需要额外处理。以下脚本演示如何创建包含子模块的完整归档：

#!/bin/sh
git archive --prefix=main/ -o main.tar HEAD
git submodule foreach --recursive 'git archive --prefix=main/$path/ HEAD > sub.tar && tar --concatenate --file=main.tar sub.tar'
gzip main.tar

增量打包技术

git bundle命令创建增量包，适用于离线环境或大仓库传输。它会生成包含特定提交范围数据的二进制文件：

# 创建包含最近5次提交的包
git bundle create updates.bundle HEAD~5..HEAD

接收方可以通过以下命令验证并应用更新：

git bundle verify updates.bundle
git fetch updates.bundle main:new-feature

归档中的路径控制

--prefix参数允许在归档内添加自定义目录层级，这对部署标准化很有帮助：

# 添加app/前缀到所有文件
git archive --prefix=app/ -o deploy.tar HEAD

结合路径筛选功能，可以只打包特定目录：

# 仅打包src目录内容
git archive HEAD -- src/ | tar -x -C ./dist

自动化部署集成

在CI/CD流程中，归档常与部署脚本结合。以下是Node.js项目的示例部署脚本：

const { execSync } = require('child_process');
const fs = require('fs');

// 生成带时间戳的归档文件
const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
const archiveName = `build-${timestamp}.zip`;

execSync(`git archive --format=zip --output=${archiveName} HEAD`);

// 添加构建后的assets目录
execSync(`zip -ur ${archiveName} public/assets`);

// 上传到AWS S3的示例
const AWS = require('aws-sdk');
const s3 = new AWS.S3();
const fileContent = fs.readFileSync(archiveName);

const params = {
  Bucket: 'deployment-bucket',
  Key: `builds/${archiveName}`,
  Body: fileContent
};

s3.upload(params, (err, data) => {
  if (err) throw err;
  console.log(`Archive uploaded at ${data.Location}`);
});

二进制文件处理策略

对于包含二进制文件的仓库，常规归档可能导致包体积过大。这时可以结合git-lfs和部分检出：

# 先归档代码文件
git archive --format=zip HEAD $(git ls-files | grep -v '\.psd$') > code.zip

# 单独处理大文件
git lfs ls-files -n | xargs zip assets.zip

归档签名验证

为保证归档完整性，可以添加GPG签名：

git archive HEAD | gpg --detach-sign > archive.tar.sig

验证时使用：

gpg --verify archive.tar.sig archive.tar

多平台打包差异

Windows和Unix系统在路径处理上有差异，跨平台项目需要特别注意：

# PowerShell中处理含中文路径的归档
git archive --output=archive.zip HEAD | Out-Null
[System.IO.Path]::GetFullPath('archive.zip')

历史版本批量归档

以下脚本可批量创建最近10个提交的独立归档：

for i in {0..9}; do
  commit=$(git rev-parse HEAD~$i)
  git archive --format=zip --output=patch-$i.zip $commit
done

与持续集成系统集成

GitLab CI示例配置，在合并请求时自动创建归档：

build_artifact:
  stage: package
  script:
    - git archive --format=zip --output=artifacts.zip $CI_COMMIT_SHA
  artifacts:
    paths:
      - artifacts.zip

归档内容预处理

通过export-ignore属性可以控制.gitattributes中指定文件的归档行为：

# .gitattributes示例
docs/* export-ignore
*.test.js export-ignore

性能优化技巧

大仓库归档时，这些方法可以提高效率：

1. 使用--worktree-attributes跳过.git目录处理
2. 在SSD存储上操作
3. 分阶段归档：

# 先创建临时索引
TEMP_INDEX=$(mktemp)
GIT_INDEX_FILE=$TEMP_INDEX git read-tree HEAD

# 从临时索引创建归档
GIT_INDEX_FILE=$TEMP_INDEX git archive --format=zip HEAD > optimized.zip
rm $TEMP_INDEX

归档元数据保留

默认情况下，Git归档不会保留所有文件属性。要保留UNIX权限和符号链接：

git archive --format=tar --prefix=project/ HEAD | (cd /target && tar --preserve-permissions -xf -)

异常处理模式

归档过程中可能遇到的常见问题及解决方案：

1. 文件名编码问题：

# 强制使用UTF-8编码
git -c core.quotepath=false archive HEAD

2. 内存不足错误：

# 使用流式处理
git archive HEAD | pigz -9 > large-repo.tar.gz

3. 路径长度限制（Windows）：

# 启用长路径支持
git config --global core.longpaths true