git fast-import --export-marks 标志

Question

git fast-import --export-marks 能够导出将标记与其创建的提交哈希相关联的文件。

到目前为止，我看到的标记不是输入中提供的标记，而是一些与输入无关的“内部标记”。

如果保留原始标记，对于导入/导出互操作不是更好吗？

Answer 1

fast-import导出标记的目的是列出提交和 blob，以供后续验证和同步。 fast-import导入标记的目的是在增量导出-导入场景中跳过提交。

╔════════════════╦══════════════════════════════════╗
║                ║        git fast-export           ║
╠════════════════╬══════════════════════════════════╣
║ --import-marks ║ 1) commits to skip during export ║
║ --export-marks ║ 2) exported commits              ║
╚════════════════╩══════════════════════════════════╝
╔════════════════╦══════════════════════════════════════╗
║                ║          git fast-import             ║
╠════════════════╬══════════════════════════════════════╣
║ --import-marks ║ 3) commits to skip during import     ║
║ --export-marks ║ 4) a) blobs                          ║
║                ║    b) imported commits, same as (2)  ║
╚════════════════╩══════════════════════════════════════╝

您可以从上表中看到在存储库增量同步的场景中如何组合标志。人们可以导出一个存储库，将其导入到其他地方，然后通过跳过以前导出的提交来创建增量导出文件，或者通过跳过已知的提交来创建完整导出并增量导入。

这是一个简短的例子来说明。

$ cd /tmp && git init example && cd example &&  touch README && \
git add README && git commit -m "first commit"
$ git fast-export --all --export-marks=/tmp/example-repo.marks > /tmp/example-repo.export
--- /tmp/example-repo.export ---
blob
mark :1
...
reset refs/heads/master
commit refs/heads/master
mark :2
...
reset refs/heads/master
from :2

--- /tmp/example-repo.marks ---
:2 610432e74c554d783ff5f9edd1bb18548d68e533

仅导出了一个标记，即添加到存储库的单个提交的标记。

$ git show 610432e74c554d783ff5f9edd1bb18548d68e533
commit 610432e74c554d783ff5f9edd1bb18548d68e533
...

当您继续重新创建存储库时，导出的标记不仅会列出提交，还会列出新的 blob。这些新的 blob 已重新创建，并出现在标记中供您检查，还列出了提交以与所有导入引用的提交进行比较。

$ cd /tmp && git init example-import && cd example-import && \
cat /tmp/example-repo.export | git fast-import --export-marks=/tmp/example-import-repo.marks

--- /tmp/example-import-repo.marks ---
:1 e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
:2 610432e74c554d783ff5f9edd1bb18548d68e533

blob :1 已重新创建，并在标记文件中新列出（使用第一个可用标记，恰好是 :1），但请注意标记的提交 < code>:2 保留了原始导出存储库中的标记和哈希值。