Win10系统Docker构建失败镜像占用空间无法定位清理求助

1. 清理Docker构建缓存 #

你之前执行的docker prune -a默认不会清理构建过程产生的中间层缓存，多次构建失败的冗余文件都存在构建缓存中：

• 先执行docker system df 可查看构建缓存（BUILD CACHE）的实际占用大小
• 执行命令清理所有未使用的构建缓存：docker builder prune -a，确认操作时输入y即可

2. 定位Docker实际存储路径 #

Windows 10默认安装的Docker Desktop使用WSL2后端，所有镜像、缓存、容器数据都存储在WSL虚拟磁盘文件中，属于系统隐藏文件，你之前未找到是因为没有开启隐藏文件显示：

• 先在文件管理器顶部「查看」选项卡勾选「隐藏的项目」，才能看到隐藏目录
• Docker默认虚拟磁盘路径：C:\Users\你的用户名\AppData\Local\Docker\wsl\data\ext4.vhdx，这个文件就是占用你C盘空间的主体

3. 手动释放虚拟磁盘冗余空间 #

WSL的虚拟磁盘文件ext4.vhdx只会自动扩容，清理Docker内部数据后不会自动缩小，需要手动收缩释放空间：

• 首先右键托盘Docker图标，选择「Quit Docker Desktop」，等待程序完全退出
• 按下Win+R输入diskpart打开磁盘分区工具，依次执行以下命令：

  select vdisk file="C:\Users\你的用户名\AppData\Local\Docker\wsl\data\ext4.vhdx"
  attach vdisk readonly
  compact vdisk
  detach vdisk
  exit
  

• 操作完成后重启Docker Desktop，即可看到C盘已释放对应空间

4. 后续避免C盘占用过高方案 #

• 可将Docker的WSL虚拟磁盘迁移到非系统盘，从根源避免占用C盘空间
• 构建镜像时尽量使用多阶段构建，减少无效中间层产生
• 定期执行docker builder prune清理无用构建缓存

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