如何通过Yocto的SRC_URI实现Git仓库的浅克隆？

云上老周

2026-8-4

Yocto实现Git仓库浅克隆（仅拉取最新提交）的方案

针对你遇到的Git仓库存放大体积二进制文件、完整克隆耗时耗空间的问题，Yocto提供两种方式实现类似git clone --depth 1的浅克隆效果：

方法一：通过SRC_URI直接配置浅克隆

Yocto的Git Fetcher原生支持depth参数，只需在SRC_URI中添加该参数即可实现仅拉取指定次数的提交历史，无需修改任务逻辑：

# 拉取main分支最新1次提交的浅克隆
SRC_URI = "git://your-repo-url.git;protocol=https;branch=main;depth=1"
# 若需指定特定提交，配合SRCREV使用
SRCREV = "abcdef1234567890abcdef1234567890abcdef12"
SRC_URI = "git://your-repo-url.git;protocol=https;rev=${SRCREV};depth=1"

depth=1：仅拉取最新的1次提交，不会下载完整历史
branch=<分支名>：指定要拉取的分支（若无需指定分支可省略）
rev=<commit哈希>：配合depth=1可拉取指定提交的浅克隆版本

方法二：重写do_fetch任务实现自定义克隆

如果需要更灵活的克隆逻辑，可以直接重写do_fetch任务，手动执行git clone --depth 1命令：

do_fetch() {
    # 清理原有克隆目录
    rm -rf ${WORKDIR}/git
    # 执行浅克隆
    git clone --depth 1 https://your-repo-url.git ${WORKDIR}/git
    # 若需切换到特定提交，添加checkout步骤
    # cd ${WORKDIR}/git && git checkout ${SRCREV}
}