开源项目 compact-wsl2-disk 常见问题解决方案

开源项目 compact-wsl2-disk 常见问题解决方案

compact-wsl2-disk A small script for Windows 10 Home users to compact their WSL2 disks 项目地址: https://gitcode.com/gh_mirrors/co/compact-wsl2-disk

项目基础介绍

compact-wsl2-disk 是一个用于 Windows 10 Home 用户的脚本，旨在压缩 WSL2（Windows Subsystem for Linux 2）的虚拟硬盘文件（vhdx）。该项目的主要目的是帮助用户减少 WSL2 虚拟硬盘文件占用的磁盘空间，从而优化系统性能。该项目使用 PowerShell 编写，适合有一定 Windows 系统管理经验的用户使用。

主要编程语言

该项目主要使用 PowerShell 编写。

新手使用注意事项及解决方案

1. 权限问题：无法以管理员身份运行脚本

问题描述：新手用户在尝试以管理员身份运行 compact-wsl2-disk.ps1 脚本时，可能会遇到权限不足的问题。

解决步骤：

1. 打开 PowerShell 终端：右键点击开始菜单中的 PowerShell 图标，选择“以管理员身份运行”。
2. 设置执行策略：在 PowerShell 终端中输入以下命令，允许执行脚本：

   Set-ExecutionPolicy RemoteSigned
   

3. 运行脚本：在 PowerShell 终端中导航到脚本所在的目录，然后运行：

   .\compact-wsl2-disk.ps1
   

2. WSL2 未正确关闭导致脚本执行失败

问题描述：在执行脚本时，WSL2 可能未正确关闭，导致脚本无法正常压缩虚拟硬盘文件。

解决步骤：

1. 手动关闭 WSL2：在 PowerShell 终端中输入以下命令，确保 WSL2 完全关闭：

   wsl --shutdown
   

2. 重新运行脚本：再次运行 compact-wsl2-disk.ps1 脚本。

3. 虚拟硬盘文件路径错误

问题描述：脚本默认查找的虚拟硬盘文件路径可能与用户的实际路径不符，导致脚本无法找到目标文件。

解决步骤：

1. 检查虚拟硬盘文件路径：确认 WSL2 虚拟硬盘文件（vhdx）的实际路径。
2. 设置环境变量：在 PowerShell 终端中设置 WSL_FOLDERS 环境变量，指定虚拟硬盘文件的路径。例如：

   $env:WSL_FOLDERS = "C:\Users\<NAME>\AppData\Local\Packages\CanonicalGroupLimited"
   

3. 重新运行脚本：再次运行 compact-wsl2-disk.ps1 脚本。

通过以上步骤，新手用户可以更好地理解和使用 compact-wsl2-disk 项目，解决常见的权限、WSL2 关闭和路径问题。

compact-wsl2-disk A small script for Windows 10 Home users to compact their WSL2 disks 项目地址: https://gitcode.com/gh_mirrors/co/compact-wsl2-disk