🔥C盘告急！WSL磁盘暴增？三招秒清20GB+空间

90%的开发者都不知道的WSL磁盘清理秘籍，从此告别C盘爆红警告

前言：为什么你的C盘总是莫名其妙被吃满？

相信很多使用WSL2的开发者都遇到过这样的困扰：明明没装什么大软件，C盘空间却像被黑洞吞噬一样快速减少。罪魁祸首往往就是WSL的虚拟磁盘文件------那个默默膨胀的ext4.vhdx、xxx.vhdx文件。

痛点直击：

Docker镜像和构建缓存无限制增长
虚拟磁盘文件碎片化严重，占用空间远超实际使用
传统清理方法治标不治本
默认安装C盘

⏰ 快速解决问题：压缩 ext4.vhdx、xxx.vhdx等虚拟系统文件, WSL 2 默认不会自动压缩虚拟磁盘，需要直接手动清理（用Windows PowerShell管理员运行）：

perl 复制代码

# Docker缓存已清理（如果你是wsl且安装了docker）
docker system prune -a --volumes --force

# 关闭所有 WSL 实例（确保虚拟磁盘文件ext4.vhdx完全卸载，避免压缩过程中出现文件锁定或数据损坏）
wsl --shutdown 

# 启动Windows自带的磁盘分区管理工具（执行高级磁盘操作，如虚拟磁盘压缩）
diskpart

# 指定需要操作的虚拟磁盘文件路径（此处示例为D盘wsl目录下的ext4.vhdx）
select vdisk file="D:\wsl\ext4.vhdx"   // 关键提示：需替换为您实际的.vhdx文件路径

# 以"只读模式"挂载虚拟磁盘（防止意外修改数据，同时允许磁盘结构优化）
attach vdisk readonly

# 执行核心压缩操作（回收已删除文件占用的空间，减小.vhdx文件的物理大小）
compact vdisk

# 安全卸载虚拟磁盘（完成压缩操作后释放文件句柄）
detach vdisk

# 退出diskpart工具（返回到PowerShell或CMD命令行环境）
exit

# 重新启动指定名称的WSL发行版（此处以Alpine为例）。注意：应替换为您的实际发行版名称（如Ubuntu-20.04）
wsl -d Alpine

如果当前清理成功，后面就可以到此结束！

下面，我将分享三个层次的解决方案，从基础清理到终极优化，让你的WSL重获新生。

一、Docker缓存智能清理：从根源解决问题

1. 配置自动清理策略（推荐方案）

WSL内部的Docker是空间杀手的第一元凶。通过合理配置，可以让Docker自动维护缓存大小：

bash 复制代码

# 编辑Docker配置文件
sudo nano /etc/docker/daemon.json

添加以下智能清理配置：

json 复制代码

{
  "features": {"buildkit": true},
  "builder": {
    "gc": {
      "enabled": true,
      "defaultKeepStorage": "5GB"  // 自动清理超过5GB的构建缓存
    }
  },
  "storage-driver": "overlay2",
  "storage-opts": [
    "overlay2.override_kernel_check=true"
  ]
}

重启Docker服务生效：

bash 复制代码

sudo service docker restart

技术原理：BuildKit的垃圾回收机制会监控构建缓存，当总大小超过5GB时自动清理最旧的缓存层。

2. 创建智能清理脚本

对于更精细的控制，创建自动化清理脚本：

bash 复制代码

#!/bin/bash
# /usr/local/bin/clean-docker
# 智能Docker清理脚本：磁盘使用率>80%时自动触发

CURRENT_USAGE=$(df -h / | awk 'NR==2{print $5}' | tr -d '%')

if [ $CURRENT_USAGE -gt 80 ]; then
    echo "[$(date)] 磁盘使用率 ${CURRENT_USAGE}%，开始自动清理..."
    
    # 清理72小时前的未使用资源
    docker system prune -a -f --filter "until=72h"
    
    # 清理构建缓存
    docker builder prune -af
    
    # 清理悬空镜像
    docker image prune -f
    
    echo "[$(date)] 清理完成，当前使用率: $(df -h / | awk 'NR==2{print $5}')"
fi

设置执行权限和定时任务：

bash 复制代码

sudo chmod +x /usr/local/bin/clean-docker

# 每天凌晨3点执行清理
(crontab -l ; echo "0 3 * * * /usr/local/bin/clean-docker >> /var/log/docker-clean.log 2>&1") | crontab -

二、WSL虚拟磁盘压缩：回收被浪费的空间

自动化压缩脚本

WSL2使用虚拟磁盘文件（VHDX），长时间使用后会产生大量碎片空间。使用以下PowerShell脚本一键压缩：

powershell 复制代码

# compress-vhdx.ps1
# WSL虚拟磁盘压缩脚本

param(
    [switch]$Force = $false
)

Write-Host "开始WSL虚拟磁盘压缩..." -ForegroundColor Green

# 1. 关闭所有WSL实例
Write-Host "正在关闭WSL实例..." -ForegroundColor Yellow
wsl --shutdown

# 2. 获取所有WSL分发版路径
$distros = @()
$lxssePaths = Get-ChildItem "HKCU:\Software\Microsoft\Windows\CurrentVersion\Lxss" -ErrorAction SilentlyContinue

foreach ($path in $lxssePaths) {
    $distroName = (Get-ItemProperty -Path "Registry::$path").DistributionName
    $basePath = (Get-ItemProperty -Path "Registry::$path").BasePath
    if ($distroName -and $basePath) {
        $distros += @{
            Name = $distroName
            Path = $basePath
        }
    }
}

# 3. 压缩所有.vhdx文件
foreach ($distro in $distros) {
    $vhdxPath = Join-Path $distro.Path "ext4.vhdx"
    
    if (Test-Path $vhdxPath) {
        Write-Host "正在压缩: $($distro.Name)" -ForegroundColor Cyan
        
        $originalSize = (Get-Item $vhdxPath).Length
        $originalSizeGB = [math]::Round($originalSize / 1GB, 2)
        
        # 创建diskpart脚本
        $diskpartScript = @"
select vdisk file="$vhdxPath"
attach vdisk readonly
compact vdisk
detach vdisk
exit
"@
        
        $diskpartScript | Out-File -FilePath "temp_diskpart.txt" -Encoding ASCII
        diskpart /s "temp_diskpart.txt" | Out-Null
        Remove-Item "temp_diskpart.txt" -Force
        
        $newSize = (Get-Item $vhdxPath).Length
        $newSizeGB = [math]::Round($newSize / 1GB, 2)
        $savedSpace = $originalSizeGB - $newSizeGB
        
        Write-Host "压缩完成: 节省 ${savedSpace}GB (${originalSizeGB}GB → ${newSizeGB}GB)" -ForegroundColor Green
    }
}

Write-Host "所有虚拟磁盘压缩完成！" -ForegroundColor Green

使用方法：

powershell 复制代码

# 以管理员身份运行
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process
.\compress-vhdx.ps1

三、终极解决方案：虚拟磁盘迁移

当上述方法仍无法满足需求时，迁移虚拟磁盘是最彻底的解决方案：

分步迁移指南

导出当前分发版：

powershell 复制代码

# 查看当前分发版
wsl -l -v

# 导出到备份文件
wsl --export Ubuntu D:\wsl-backup\ubuntu-backup.tar

注销旧分发版：
powershell 复制代码
```
wsl --unregister Ubuntu
```

导入到新位置：

powershell 复制代码

# 创建目标目录
mkdir D:\wsl-new\ubuntu

# 导入并优化磁盘结构
wsl --import Ubuntu-New D:\wsl-new\ubuntu D:\wsl-backup\ubuntu-backup.tar --version 2

设置默认用户：

bash 复制代码

# 在Windows中设置默认用户
Ubuntu-New config --default-user yourusername

四、高级优化技巧

1. WSL配置文件优化

在%USERPROFILE%\.wslconfig中添加：

ini 复制代码

[wsl2]
memory=4GB       # 限制内存使用
processors=4     # 限制CPU核心数
swap=1GB         # 交换文件大小
localhostForwarding=true

# 磁盘性能优化
autoMemoryReclaim=gradual   # 内存自动回收
sparseVhd=true             # 稀疏虚拟磁盘

2. 文件系统优化

在WSL内部优化文件系统性能：

bash 复制代码

# 定期清理日志和缓存
sudo apt autoremove -y
sudo apt clean
sudo journalctl --vacuum-time=7d

# 优化ext4文件系统
sudo fstrim /

3. 监控脚本

创建磁盘使用监控脚本：

bash 复制代码

#!/bin/bash
# /usr/local/bin/wsl-disk-monitor

# 监控WSL磁盘使用情况
CURRENT_USAGE=$(df -h / | awk 'NR==2{print $5}' | tr -d '%')
TOTAL_SIZE=$(df -h / | awk 'NR==2{print $2}')
USED_SIZE=$(df -h / | awk 'NR==2{print $3}')

echo "WSL磁盘使用报告:"
echo "总大小: $TOTAL_SIZE"
echo "已使用: $USED_SIZE"
echo "使用率: ${CURRENT_USAGE}%"

if [ $CURRENT_USAGE -gt 90 ]; then
    echo "警告：磁盘使用率超过90%，建议立即清理！"
    /usr/local/bin/clean-docker
fi

实践建议与最佳实践

定期维护计划：
- 每周：执行Docker清理脚本
- 每月：运行虚拟磁盘压缩
- 每季度：考虑虚拟磁盘迁移
预防措施：
- 避免在WSL中存储大型文件
- 使用Docker的.dockerignore文件减少构建上下文
- 定期清理无用的Docker镜像和容器
监控工具推荐：
- ncdu：WSL内部的磁盘分析工具
- WSL2 Disk Usage：Windows端的可视化工具
- 自定义监控脚本实时预警

结语

通过这三个层次的清理方案，你可以有效解决WSL磁盘空间问题。从智能的Docker缓存管理，到虚拟磁盘的定期压缩，再到彻底的迁移方案，每一招都能为你节省宝贵的磁盘空间。

补充说明

必要性：WSL 2虚拟磁盘不会自动回收空间，删除文件后.vhdx大小不变，必须定期手动压缩
最佳实践：建议每月执行一次该流程，尤其在大量文件操作后。
风险规避 ：务必通过wsl --shutdown确保WSL完全关闭，否则可能导致压缩失败或数据损坏
路径验证 ：若不确定.vhdx路径，可通过PowerShell运行：
Get-ChildItem HKCU:\Software\Microsoft\Windows\CurrentVersion\Lxss*\ | % {Get-ItemProperty $_.PSPath} | Select DistributionName,BasePath

记住：预防胜于治疗。建立定期维护习惯，让你的开发环境始终保持最佳状态。

技术提示：Docker清理在WSL内部操作，虚拟磁盘压缩在Windows端执行，迁移方案需要两者配合。建议每月执行一次完整维护流程