1. 为什么需要迁移WSL2到非系统盘很多开发者第一次接触WSL2时都会直接从微软商店安装Ubuntu发行版。默认情况下系统会把所有文件存放在C盘的隐藏目录里。随着使用时间增长你会发现C盘空间莫名其妙被吃掉几十GB。我去年就遇到过C盘只剩3GB的窘况连Windows更新都提示空间不足。WSL2的磁盘占用主要来自三个方面首先是基础系统文件Ubuntu 20.04初始安装大约占用1.5GB其次是apt安装的软件包像Python全家桶、Docker这些开发环境轻松吃掉5GB最可怕的是项目数据比如训练机器学习模型时生成的临时文件我曾经有个TensorFlow项目单数据集就占了20GB。更麻烦的是WSL2使用的是动态扩容的虚拟硬盘ext4.vhdx这个文件会随着使用不断膨胀但不会自动收缩。即便删除了里面的文件虚拟硬盘占用的物理空间也不会释放。有次我清理了Ubuntu里10GB的缓存文件回到Windows查看vhdx文件大小纹丝不动。2. 迁移前的准备工作2.1 检查当前WSL状态首先打开PowerShell管理员权限运行wsl -l -v这个命令会列出所有已安装的WSL发行版及其状态。确认你要迁移的Ubuntu 20.04处于Stopped状态。如果显示Running需要先执行wsl -t Ubuntu-20.04接着查看当前虚拟硬盘的位置和大小Get-ChildItem C:\Users\你的用户名\AppData\Local\Packages\CanonicalGroupLimited*\LocalState\*.vhdx | Select-Object FullName,Length记下这个vhdx文件的路径稍后导出时会用到。我的机器上显示大小是27.8GB而实际Ubuntu系统只用到了15GB左右。2.2 准备目标存储位置在目标盘比如D盘创建存放目录。建议路径不要包含中文和空格mkdir D:\WSL\Ubuntu2004考虑到未来可能安装多个WSL实例可以建立层级目录结构。我个人的习惯是按发行版和用途分类D:\WSL ├── Ubuntu2004 ├── Ubuntu2204 └── Kali注意确保目标分区有足够剩余空间。建议至少保留原vhdx文件1.5倍的可用空间以防导出过程中需要临时存储。3. 完整迁移操作步骤3.1 导出现有系统镜像在PowerShell执行导出命令这相当于给WSL系统做个快照wsl --export Ubuntu-20.04 D:\WSL\temp.tar这个过程可能会持续5-15分钟取决于你的系统大小。我的27GB镜像用了约8分钟完成导出生成的temp.tar文件大小是14GB。3.2 导入到新位置关键命令来了wsl --import Ubuntu-20.04-new D:\WSL\Ubuntu2004 D:\WSL\temp.tar --version 2参数说明Ubuntu-20.04-new是新实例的名称后续可以改名D:\WSL\Ubuntu2004是目标路径temp.tar是上一步导出的镜像--version 2指定使用WSL2导入完成后立即删除临时文件释放空间del D:\WSL\temp.tar3.3 设置默认用户导入的新实例默认以root身份登录需要修改注册表设置默认用户。新建reg文件并写入以下内容Windows Registry Editor Version 5.00 [HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Lxss\{你的分发版ID}] DefaultUiddword:000003e8分发版ID可以通过命令获取wsl -l -v然后在注册表编辑器中找到对应项将DefaultUid值改为你的用户UID十进制1000对应十六进制3E8。4. 迁移后的优化配置4.1 清理旧系统确认新系统运行正常后可以卸载原系统释放C盘空间wsl --unregister Ubuntu-20.04然后手动删除残留文件Remove-Item -Path C:\Users\你的用户名\AppData\Local\Packages\CanonicalGroupLimited* -Recurse -Force4.2 配置快捷方式在桌面新建快捷方式目标位置填写wsl -d Ubuntu-20.04-new如果想保留原名称可以先注销旧实例然后重命名新实例wsl --unregister Ubuntu-20.04 wsl --import Ubuntu-20.04 D:\WSL\Ubuntu2004 D:\WSL\Ubuntu2004\ext4.vhdx --version 24.3 磁盘空间回收技巧WSL2的虚拟硬盘不会自动收缩需要手动压缩。首先在Ubuntu内运行sudo apt install zerofree sudo zerofree -v /dev/sda1然后在PowerShell执行wsl --shutdown diskpart select vdisk fileD:\WSL\Ubuntu2004\ext4.vhdx attach vdisk readonly compact vdisk detach vdisk exit这套操作让我的vhdx文件从27GB缩小到了15GB。建议每月执行一次维护。5. 常见问题解决方案5.1 导入后无法启动如果遇到错误码0x800700b7通常是权限问题。尝试icacls D:\WSL\Ubuntu2004 /grant 你的用户名:(OI)(CI)F然后重新导入镜像。5.2 网络连接异常迁移后可能会出现apt无法更新的情况。在Ubuntu内执行sudo rm /etc/resolv.conf sudo bash -c echo nameserver 8.8.8.8 /etc/resolv.conf sudo chattr i /etc/resolv.conf5.3 性能调优建议在.wslconfig文件中添加以下配置位于用户目录下[wsl2] memory8GB processors4 localhostForwardingtrue这可以避免WSL2占用过多主机资源特别是当你有大内存需求时。迁移完成后我的C盘瞬间多出30GB空间再也不用每天清理临时文件了。有个细节提醒大家如果你使用Docker Desktop with WSL2记得在设置里将新创建的WSL实例设为默认否则它可能还会继续使用C盘空间。
告别C盘焦虑：手把手教你将WSL2 Ubuntu 20.04迁移至非系统盘
1. 为什么需要迁移WSL2到非系统盘很多开发者第一次接触WSL2时都会直接从微软商店安装Ubuntu发行版。默认情况下系统会把所有文件存放在C盘的隐藏目录里。随着使用时间增长你会发现C盘空间莫名其妙被吃掉几十GB。我去年就遇到过C盘只剩3GB的窘况连Windows更新都提示空间不足。WSL2的磁盘占用主要来自三个方面首先是基础系统文件Ubuntu 20.04初始安装大约占用1.5GB其次是apt安装的软件包像Python全家桶、Docker这些开发环境轻松吃掉5GB最可怕的是项目数据比如训练机器学习模型时生成的临时文件我曾经有个TensorFlow项目单数据集就占了20GB。更麻烦的是WSL2使用的是动态扩容的虚拟硬盘ext4.vhdx这个文件会随着使用不断膨胀但不会自动收缩。即便删除了里面的文件虚拟硬盘占用的物理空间也不会释放。有次我清理了Ubuntu里10GB的缓存文件回到Windows查看vhdx文件大小纹丝不动。2. 迁移前的准备工作2.1 检查当前WSL状态首先打开PowerShell管理员权限运行wsl -l -v这个命令会列出所有已安装的WSL发行版及其状态。确认你要迁移的Ubuntu 20.04处于Stopped状态。如果显示Running需要先执行wsl -t Ubuntu-20.04接着查看当前虚拟硬盘的位置和大小Get-ChildItem C:\Users\你的用户名\AppData\Local\Packages\CanonicalGroupLimited*\LocalState\*.vhdx | Select-Object FullName,Length记下这个vhdx文件的路径稍后导出时会用到。我的机器上显示大小是27.8GB而实际Ubuntu系统只用到了15GB左右。2.2 准备目标存储位置在目标盘比如D盘创建存放目录。建议路径不要包含中文和空格mkdir D:\WSL\Ubuntu2004考虑到未来可能安装多个WSL实例可以建立层级目录结构。我个人的习惯是按发行版和用途分类D:\WSL ├── Ubuntu2004 ├── Ubuntu2204 └── Kali注意确保目标分区有足够剩余空间。建议至少保留原vhdx文件1.5倍的可用空间以防导出过程中需要临时存储。3. 完整迁移操作步骤3.1 导出现有系统镜像在PowerShell执行导出命令这相当于给WSL系统做个快照wsl --export Ubuntu-20.04 D:\WSL\temp.tar这个过程可能会持续5-15分钟取决于你的系统大小。我的27GB镜像用了约8分钟完成导出生成的temp.tar文件大小是14GB。3.2 导入到新位置关键命令来了wsl --import Ubuntu-20.04-new D:\WSL\Ubuntu2004 D:\WSL\temp.tar --version 2参数说明Ubuntu-20.04-new是新实例的名称后续可以改名D:\WSL\Ubuntu2004是目标路径temp.tar是上一步导出的镜像--version 2指定使用WSL2导入完成后立即删除临时文件释放空间del D:\WSL\temp.tar3.3 设置默认用户导入的新实例默认以root身份登录需要修改注册表设置默认用户。新建reg文件并写入以下内容Windows Registry Editor Version 5.00 [HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Lxss\{你的分发版ID}] DefaultUiddword:000003e8分发版ID可以通过命令获取wsl -l -v然后在注册表编辑器中找到对应项将DefaultUid值改为你的用户UID十进制1000对应十六进制3E8。4. 迁移后的优化配置4.1 清理旧系统确认新系统运行正常后可以卸载原系统释放C盘空间wsl --unregister Ubuntu-20.04然后手动删除残留文件Remove-Item -Path C:\Users\你的用户名\AppData\Local\Packages\CanonicalGroupLimited* -Recurse -Force4.2 配置快捷方式在桌面新建快捷方式目标位置填写wsl -d Ubuntu-20.04-new如果想保留原名称可以先注销旧实例然后重命名新实例wsl --unregister Ubuntu-20.04 wsl --import Ubuntu-20.04 D:\WSL\Ubuntu2004 D:\WSL\Ubuntu2004\ext4.vhdx --version 24.3 磁盘空间回收技巧WSL2的虚拟硬盘不会自动收缩需要手动压缩。首先在Ubuntu内运行sudo apt install zerofree sudo zerofree -v /dev/sda1然后在PowerShell执行wsl --shutdown diskpart select vdisk fileD:\WSL\Ubuntu2004\ext4.vhdx attach vdisk readonly compact vdisk detach vdisk exit这套操作让我的vhdx文件从27GB缩小到了15GB。建议每月执行一次维护。5. 常见问题解决方案5.1 导入后无法启动如果遇到错误码0x800700b7通常是权限问题。尝试icacls D:\WSL\Ubuntu2004 /grant 你的用户名:(OI)(CI)F然后重新导入镜像。5.2 网络连接异常迁移后可能会出现apt无法更新的情况。在Ubuntu内执行sudo rm /etc/resolv.conf sudo bash -c echo nameserver 8.8.8.8 /etc/resolv.conf sudo chattr i /etc/resolv.conf5.3 性能调优建议在.wslconfig文件中添加以下配置位于用户目录下[wsl2] memory8GB processors4 localhostForwardingtrue这可以避免WSL2占用过多主机资源特别是当你有大内存需求时。迁移完成后我的C盘瞬间多出30GB空间再也不用每天清理临时文件了。有个细节提醒大家如果你使用Docker Desktop with WSL2记得在设置里将新创建的WSL实例设为默认否则它可能还会继续使用C盘空间。
