Windows11从零开始配置 WSL2 并安装 Ubuntu（新手友好）

从零开始配置 WSL2 并安装 Ubuntu直装 E 盘完美避开 Microsoft Store 和网络超时新手友好 | 含踩坑实录 | 100% 成功率 | C盘零占用 为什么要写这篇教程最近在 Windows 11 上配置 Linux 开发环境本以为wsl --install一条命令就能搞定结果一路踩坑Microsoft Store 下载 Ubuntu 无限排队wsl --status提示“未找到 WSL 2 内核文件”wsl --update卡在[ 0.0% ]一动不动wsl --install因为 GitHub 连接超时而失败下载错了arm64版本导致“灾难性故障”折腾了整整一下午终于把所有问题都解决了。我把整个过程整理成这篇从零开始的完整教程帮你一次性避开所有坑半小时内搞定一个干净、独立、高效的 WSL Ubuntu 开发环境。 本教程能帮你实现什么项目最终效果系统Windows 11Win10 版本 2004 也适用WSL 版本WSL 2Ubuntu 版本Ubuntu 22.04.5 LTS安装位置E:\WSL\Ubuntu可自定义完全避开 C 盘默认用户自定义普通用户具有sudo权限安装方式完全绕过 Microsoft Store 和 GitHub 列表请求 目录前置检查你的电脑支持 WSL 吗启用 WSL 功能安装 WSL 2 内核离线方式避开卡 0%手动下载 Ubuntu 镜像绕过网络超时导入 Ubuntu 到 E 盘创建普通用户并设为默认最终验证常用命令速查️ 第一步前置检查你的电脑支持 WSL 吗1.1 确认 Windows 版本按Win R输入winver回车查看版本信息。要求Windows 10 版本 2004 或更高内部版本号 19041或 Windows 11。如果版本过低请先更新 Windows。1.2 确认虚拟化已开启方式1打开任务管理器Ctrl Shift Esc点击“性能”标签在右下角查看“虚拟化”状态。✅ 如果显示“已启用”继续下一步。❌ 如果显示“已禁用”需要进入电脑 BIOS/UEFI 设置中开启Intel VT-x 或 AMD-V具体方法请根据你的电脑品牌搜索“如何开启虚拟化”。若未找到该信息采用方式2进行查看方式2打开系统信息工具查看更可靠按 Win R输入 msinfo32然后回车。在弹出的“系统信息”窗口中在右侧的列表里找到“基于虚拟化的安全性”这一项查看是否打开⚙️ 第二步启用 WSL 功能方式1以管理员身份打开 PowerShell右键点击“开始”菜单 → “Windows PowerShell (管理员)”依次执行以下两条命令dism.exe/online/enable-feature/featurename:Microsoft-Windows-Subsystem-Linux/all/norestartdism.exe/online/enable-feature/featurename:VirtualMachinePlatform/all/norestart执行完毕后重启电脑。方式2打开启用和关闭Windows功能页面勾选适用于Linux的Windows子系统点击确认后重启电脑执行配置 第三步安装 WSL 2 内核关键步骤重启后以管理员身份打开 PowerShell执行wsl --status查看状态。如果显示“未找到 WSL 2 内核文件”说明需要手动安装内核。不要执行wsl --update它很可能卡在 0% 不动。✅ 正确做法离线下载 MSI 安装包下载微软官方内核安装包约 50MBhttps://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi如果官方链接下载慢可以在浏览器搜索“wsl_update_x64.msi GitHub”获取。下载完成后双击运行wsl_update_x64.msi一路点击 Next 完成安装只需十几秒。验证内核是否安装成功wsl--status如果不再显示“未找到 WSL 2 内核文件”说明内核已就绪。可选将 WSL 2 设为默认版本wsl--set-default-version 2 第四步手动下载 Ubuntu 镜像核心操作为什么不用wsl --install因为wsl --install会先请求 GitHub 的https://raw.githubusercontent.com/microsoft/WSL/master/distributions/DistributionInfo.json来获取发行版列表国内访问 GitHub 经常超时导致安装失败。即使加了--web-download参数也无法绕过这个请求。也可以尝试开梯子进行安装但并不稳定。推荐解决方案直接下载 Ubuntu 镜像文件rootfs然后手动导入。4.1 下载正确的 RootFS 文件⚠️ 注意架构千万不要下载arm64版本大多数 Windows 电脑是 x64 架构下载arm64会导致启动时报“灾难性故障”。正确版本文件名中带amd64。推荐下载源国内访问更快镜像源地址清华大学镜像首选https://mirrors.tuna.tsinghua.edu.cn/ubuntu-cloud-images/wsl/jammy/current/中科大镜像备用https://mirrors.ustc.edu.cn/ubuntu-cloud-images/wsl/jammy/current/Ubuntu 官方源备用https://cloud-images.ubuntu.com/wsl/jammy/current/在目录中找到并下载ubuntu-jammy-wsl-amd64-wsl.rootfs.tar.gz文件大小约 100~200MB下载到你方便找到的位置比如D:\Download\。 第五步导入 Ubuntu 到 E 盘5.1 创建安装目录在 E 盘创建一个文件夹用于存放 Ubuntu 系统文件路径可以自定义方法一手动打开文件资源管理器进入 E 盘依次创建WSL\Ubuntu文件夹。方法二命令在管理员 PowerShell 中执行mkdir E:\WSL\Ubuntu5.2 执行导入命令在管理员 PowerShell 中执行以下命令注意替换文件路径中的用户名和文件名wsl--import Ubuntu E:\WSL\Ubuntu D:\Download\ubuntu-jammy-wsl-amd64-wsl.rootfs.tar.gz--version 2参数说明Ubuntu给发行版起的名字可自定义。E:\WSL\Ubuntu系统文件的安装位置与你创建的目录一致。D:\Download\...你下载的.tar.gz文件的实际路径。--version 2指定使用 WSL 2。看到操作成功完成说明导入成功5.3 验证安装wsl-l-v预期输出NAME STATE VERSION * Ubuntu Stopped 2 第六步创建普通用户并设为默认通过wsl --import导入的系统默认用户是root超级管理员。日常使用不建议用 root需要创建一个普通用户。6.1 启动 Ubuntu以 root 身份wsl-d Ubuntu此时提示符为root你的电脑名:~#。6.2 创建普通用户例如user1在 Ubuntu 命令行中依次执行以下命令将user1替换为你喜欢的用户名建议全小写# 创建用户-m 创建家目录-s 指定默认 shelluseradd-m-s/bin/bash user1# 设置密码输入时屏幕不显示输完按回车passwduser1# 将用户加入 sudo 组使其拥有管理员权限usermod-aGsudouser16.3 设置默认登录用户ubuntu.exe config --default-user和wsl --set-default-user在通过wsl --import安装的系统上可能不支持因此我们使用配置文件方式在 Ubuntu 中仍在 root 状态下执行echo-e[user]\ndefaultuser1/etc/wsl.conf退出 Ubuntuexit重启 WSL 使配置生效wsl--shutdown✅ 第七步最终验证7.1 重新启动 Ubuntuwsl-d Ubuntu此时应该自动以你创建的用户如user1登录提示符变为user1你的电脑名:~$。7.2 确认当前用户whoami输出应为user1。7.3 测试 sudo 权限sudoaptupdate输入你为kun设置的密码如果正常拉取软件包列表不会报错说明一切正常7.4 可选更新所有软件包sudoaptupgrade-y 第八步常用命令速查️ 在 WindowsPowerShell中操作命令启动 Ubuntuwsl -d Ubuntu以 root 身份启动wsl -d Ubuntu -u root查看已安装的发行版wsl -l -v关闭所有 WSL释放内存wsl --shutdown 在 Ubuntu 中操作命令访问 Windows E 盘cd /mnt/e/访问 Windows C 盘cd /mnt/c/更新软件包列表sudo apt update升级所有软件包sudo apt upgrade -y安装软件如 gitsudo apt install git -y 总结安装过程中的关键决策阶段遇到的问题解决方案WSL 功能启用虚拟化未开启进 BIOS 开启 Intel VT-x / AMD-V内核安装wsl --update卡在 0%手动下载.msi离线安装发行版安装wsl --install连接 GitHub 超时放弃在线安装改用 RootFS 手动导入文件下载下载了arm64版本导致报错重新下载amd64架构版本用户设置ubuntu.exe命令找不到使用/etc/wsl.conf配置文件设置默认用户空间占用不想占用 C 盘导入时直接指定 E 盘路径一步到位 最后的话整个过程虽然比一键安装曲折但一次性解决了C 盘空间占用、网络超时和权限配置三个核心痛点。这套方法不依赖任何网络环境无论你在哪里都能复现。以后重装系统或换电脑照着这份教程操作半小时内就能搞定一个干净、独立、高效的 Linux 开发环境。如果这篇文章帮到了你欢迎收藏、点赞、评论如果在操作中遇到问题也欢迎在评论区留言交流。 附录本文涉及的所有下载链接内容链接WSL 2 内核安装包https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msiUbuntu 22.04 RootFS清华镜像https://mirrors.tuna.tsinghua.edu.cn/ubuntu-cloud-images/wsl/jammy/current/Ubuntu 22.04 RootFS官方源https://cloud-images.ubuntu.com/wsl/jammy/current/本文基于 Windows 11 Ubuntu 22.04.5 LTS 环境实测完成最后更新于 2026 年 7 月。