Mac构建Docker镜像提示no space left on device问题咨询

Mac版Docker所有镜像、容器、构建缓存都存储在Docker Desktop专属的Linux虚拟磁盘文件中（通常是.raw或.qcow2格式），不会直接调用你宿主机的物理磁盘空间。你看到的主盘170G剩余、外挂盘900G剩余是宿主机的可用空间，和Docker运行环境实际能使用的空间无关：Docker虚拟磁盘有预先设置的容量上限，默认配置一般仅为64G，一旦虚拟磁盘内部空间用满，哪怕宿主机剩余空间再多，构建镜像时都会抛出no space left on device错误。
docker system prune仅能临时生效的原因也很明确：该命令只是删除虚拟磁盘内部存储的废弃镜像、停止的容器、冗余构建缓存，但不会自动缩减虚拟磁盘文件本身占用的宿主机空间，且后续构建产生的新缓存会很快再次触及虚拟磁盘容量上限，无法从根源解决问题。

执行以下操作确认问题：

• 运行任意测试容器，在容器内执行df -h /，查看根路径的磁盘使用率，如果显示使用率100%，即可确认是Docker虚拟磁盘空间耗尽。
• 查看默认路径下的虚拟磁盘文件~/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw的文件大小，若该文件大小等于你在Docker设置中分配的虚拟磁盘容量上限，即可进一步验证判断。

• 调整虚拟磁盘容量上限
  打开Docker Desktop设置面板，进入Resources（资源）选项页，找到Disk image size（磁盘镜像大小）配置项，拖动滑块将容量调整到满足使用需求的数值（比如设置为200G），点击应用等待Docker重启即可，该操作不会丢失现有容器、镜像数据。
• 迁移虚拟磁盘到大容量外挂盘
  如果不想占用主磁盘空间，仍在Resources设置页找到Disk image location（磁盘镜像存储位置）配置项，选择你剩余900G的外挂盘下的专属目录，Docker会自动完成现有虚拟磁盘文件的迁移，重启后所有Docker相关数据都会存储到外挂盘，不再占用主盘空间。
• 触发虚拟磁盘空间回收
  先执行全量清理命令（注意：该命令会删除所有未运行的容器、未被引用的镜像、构建缓存、未使用的数据卷，执行前确认相关数据无留存必要）：
  docker system prune -a --volumes
  清理完成后，在Docker资源设置页先把虚拟磁盘容量调小1-2G，点击应用重启，Docker会自动压缩虚拟磁盘文件，将之前占用的宿主机空间释放，重启完成后再把容量调回你需要的数值即可。

• 构建镜像时一定要在项目目录下执行docker build，同时编写.dockerignore文件排除无关文件，避免把整个宿主机大目录作为构建上下文打包传给Docker daemon，否则哪怕最终镜像只有900M，构建过程中产生的临时文件、上下文传输缓存也可能瞬间占满虚拟磁盘。
• 4.0以下旧版本Docker Desktop不支持虚拟磁盘自动trim，清理后空间无法自动回收，升级到最新稳定版本可大幅减少此类问题出现概率。

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