1 背景说明在上一篇文章《树莓派烧录sd卡因内存过大导致失败的解决方法不用虚拟机》中我们介绍了如何通过 WSLWindows Subsystem for Linux在 Windows 环境下使用 PiShrink 工具对镜像进行压缩。不过在实际配置 WSL 的过程中由于网络环境、系统设置等多方面因素的影响难免会遇到一些安装报错。本文将针对这些常见问题进行汇总并给出相应的处理思路希望能帮助大家更顺利地完成环境搭建。2 常见报错及处理建议2.1 报错一下载请求超时2.1.1 报错现象在 PowerShell 中执行安装命令后系统提示powershellPS C:\Users\PC wsl --install 无法从 https://raw.githubusercontent.com/microsoft/WSL/master/distributions/DistributionInfo.json 提取通讯组列表。操作超时 错误代码: Wsl/InstallDistro/WININET_E_TIMEOUT2.1.2 原因分析该问题通常与本地网络环境有关。例如电脑上开启了网络代理工具、VPN 或游戏加速器等这些软件可能干扰或延迟了 WSL 安装服务的正常请求。2.1.3 处理建议方法一在安装WSL前暂时关闭电脑上正在运行的代理或VPN类软件然后再重新尝试安装。方法二如果当前网络条件有限可以尝试切换至手机热点或其他网络环境排除当前宽带/路由器的限制。2.2 报错二服务器运行失败2.2.1 报错现象powershellPS C:\Users\PC wsl --install 正在安装: 适用于 Linux 的 Windows 子系统 服务器运行失败 0.0% ]2.2.2 原因分析除网络因素外该问题的最常见原因是系统虚拟化功能未开启或WSL依赖的Windows组件未被启用。2.2.3 处理步骤步骤一检查当前虚拟化状态按Ctrl Shift Esc打开任务管理器。切换到“性能”选项卡点击左侧的“CPU”。在右侧信息中找到“虚拟化:”这一项。如果显示“已启用”说明BIOS设置正确可以直接跳到步骤三。如果显示“已禁用”则需要进入BIOS/UEFI设置开启它。步骤二在BIOS/UEFI中开启虚拟化进入BIOS有两种常用方式方式一传统按键重启电脑在开机过程中根据主板品牌反复按下对应按键通常为Delete、F2、F10或Esc。方式二通过Windows设置按Win I打开Windows“设置”。进入“系统”-“恢复”。在“高级启动”旁边点击“立即重新启动”请提前保存工作。电脑重启后进入蓝色屏幕的“选择一个选项”界面依次点击“疑难解答”“高级选项”“UEFI固件设置”“重启”即可自动进入BIOS界面。进入BIOS后找到“高级(Advanced)”或“CPU配置(CPU Configuration)”菜单根据CPU类型启用对应选项Intel CPU启用Intel Virtualization Technology或VT-x。AMD CPU启用SVM Mode或AMD-V。部分笔记本或品牌机的路径可能略有不同例如在“Security”菜单下的“Virtualization”子选项中。确保相关选项均设为“Enabled”然后保存并退出电脑会自动重启。步骤三确认并继续安装重启回到Windows后再次打开任务管理器确认“虚拟化”状态已变为“已启用”即可重新运行wsl --install进行安装。