为何在新初始化的Git仓库中执行docker build会出现警告？

为什么Docker Build会和Git交互？ #

Docker 23.0.0默认启用了Buildx（新一代构建工具），它会自动扫描构建上下文所在的Git仓库，收集元数据（比如当前commit哈希、分支名），目的是给镜像嵌入构建溯源信息，方便后续排查镜像对应的代码版本。这就是docker build触发Git操作的核心原因。

警告出现的具体原因 #

你只执行了git init初始化仓库，但没有任何提交记录——空Git仓库里的HEAD没有指向任何有效提交，再加上Git 2.11.0版本对这种场景的处理比较严格，导致Buildx调用Git命令获取commit信息时失败，就抛出了那个警告。

解决办法 #

1. 给仓库做初始提交 #

执行以下命令完成第一次提交，让HEAD有有效指向：

git add .
git commit -m "initial commit"

之后再执行docker build，警告就会消失。

2. 禁用Buildx收集Git元数据 #

构建时添加参数，直接跳过Git元数据收集：

docker build --build-arg BUILDKIT_CONTEXT_KEEP_GIT_DIR=0 -t tmp:tmp .

或者先设置环境变量再构建：

export BUILDKIT_CONTEXT_KEEP_GIT_DIR=0
docker build -t tmp:tmp .

3. 临时切换回旧构建器（不推荐） #

如果暂时不想用Buildx，可以切换到默认的旧构建器：

docker buildx use default --default

不过Buildx是Docker官方主推的新一代构建工具，长期来看还是建议适应它的逻辑。

内容的提问来源于stack exchange，提问作者StoneThrow