Windows环境下Dockerfile 1.7-labs版本不识别--exclude标志问题

问题原因和解决办法 #

1. 确认Docker Compose启用Buildkit #

Windows环境默认可能没开Buildkit，而--exclude是Buildkit专属特性，两种开启方式：

• 临时生效：执行docker compose build前，先在PowerShell里运行：

  $env:DOCKER_BUILDKIT=1
  

• 永久生效：打开%USERPROFILE%\.docker\config.json，添加以下配置后重启Docker Desktop：

  {
    "features": {
      "buildkit": true
    }
  }
  

  也可以直接在Docker Desktop的设置 > Docker Engine中添加这段配置，保存后重启。

2. 调整路径格式适配Windows容器 #

Windows容器的路径分隔符要用反斜杠\，你当前用的正斜杠/可能导致解析异常，修改COPY指令为：

COPY --exclude=bin\big_annoying.dll bin bin

3. 验证Buildkit在Windows容器下的有效性 #

Windows容器对Buildkit的支持有部分限制，先试试用docker build直接测试：

docker build --buildkit -t test-image .

如果这个命令能成功，说明是Docker Compose的Buildkit配置问题；如果还是报错，大概率是当前Buildkit版本对Windows容器的--exclude支持不完善，可以升级Docker Desktop到最新版，或者换用其他方式排除文件。

替代方案：使用.dockerignore文件 #

要是上面的方法都无效，直接在项目根目录创建.dockerignore文件，写入：

bin/big_annoying.dll

然后把Dockerfile里的COPY指令改成：

COPY bin bin

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