如何解决Docker占用磁盘空间过大的问题？

1. 修复WSL虚拟磁盘空间不回收的问题 #

WSL的虚拟磁盘（.vhdx）不会自动收缩，即便Docker删除镜像/容器，磁盘文件也不会主动释放空间。手动触发回收：

• 关闭Docker Desktop和所有WSL发行版：

  wsl --shutdown
  

• 打开管理员权限的PowerShell，定位到Docker的WSL数据盘（默认路径为%localappdata%\Docker\wsl\data\ext4.vhdx），执行空间优化命令：

  optimize-vhd -Path "C:\Users\<你的用户名>\AppData\Local\Docker\wsl\data\ext4.vhdx" -Mode Full
  

  这个命令会真正回收虚拟磁盘中未使用的空间，解决docker system prune -a显示释放空间但实际未生效的问题。

2. 彻底迁移Docker的WSL存储到其他磁盘 #

之前的迁移操作可能未完全生效，试试完整步骤：

• 先关闭Docker和WSL：

  wsl --shutdown
  

• 导出Docker的WSL发行版到目标磁盘（比如D盘）：

  wsl --export docker-desktop-data "D:\Docker\docker-desktop-data.tar"
  

• 删除原有的WSL发行版：

  wsl --unregister docker-desktop-data
  

• 从导出文件重新导入到目标路径：

  wsl --import docker-desktop-data "D:\Docker\data" "D:\Docker\docker-desktop-data.tar" --version 2
  

• 启动Docker Desktop，确认存储路径已切换后，可删除导出的.tar文件。

3. 排查并清理Docker隐藏空间占用 #

• 查看Docker各组件的详细空间使用情况，定位占用源头：

  docker system df -v
  

  该命令会列出镜像、容器、卷、构建缓存的具体占用，未清理的卷或构建缓存常是隐形空间大户。
• 清理所有未使用的卷（注意备份重要数据）：

  docker volume prune -f
  

• 清理Docker BuildKit缓存（若开启了BuildKit）：

  docker builder prune -a -f
  

4. 设置Docker Desktop磁盘限额 #

打开Docker Desktop设置，进入Resources > Advanced，配置合理的磁盘限额，避免WSL虚拟磁盘无限制膨胀。默认未设置限额时，磁盘可能被持续占满。

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