2026最新 WSL(Windows Subsystem for Linux)安装教程(保姆级,图文讲解,带安装包)WSL(Windows Subsystem for Linux)是微软官方推出的 Windows 系统下的 Linux 子系统解决方案,无需安装虚拟机或搭建双系统,就能让 Windows 10/11 用户直接运行原生 Linux 命令行工具、各类程序及服务,极大降低了开发者和 Linux 爱好者的使用门槛。本教程专为零基础用户打造,涵盖完整安装流程、详细操作步骤、常见问题排查,同时附赠离线安装包,确保无网络或网络受限环境下也能顺利部署。


一、下载 WSL

(一)网盘下载(推荐)

为避免大家繁琐的官网查找流程,特意整理了最新版 WSL 离线安装包,

方便快速获取:点击下载安装包

(二)在线商店下载(适合网络通畅环境)

  1. 打开 Windows 自带的 Microsoft Store(微软应用商店),在搜索框中直接输入 “WSL”;
  2. 搜索结果中会显示 “Windows Subsystem for Linux”(核心组件)及各类 Linux 发行版本(如 Ubuntu、Debian 等);
  3. 先点击 “Windows Subsystem for Linux” 进行免费下载安装(核心组件必须安装);
  4. 再选择所需的 Linux 发行版(推荐新手选择 Ubuntu 22.04 LTS 或 Ubuntu 24.04 LTS,兼容性更强),点击 “免费下载” 即可。

二、安装 WSL(分步操作,全程图文指引)

步骤 1:启用 WSL 核心功能(关键步骤,需管理员权限)

  1. 按下快捷键Win+X,在弹出的菜单中选择 “Windows PowerShell (管理员)(A)”(部分系统显示为 “终端 (管理员)”);
  2. 在打开的 PowerShell 窗口中,输入以下命令并按下回车:

plaintext

wsl --install
  1. 执行后系统会自动启用 “适用于 Linux 的 Windows 子系统” 和 “虚拟机平台” 两个核心功能,同时开始下载默认的 Linux 发行版;
  2. 等待命令执行完成后,会提示 “请求的操作成功。直到重新启动系统前更改将不会生效”,此时关闭 PowerShell,重启电脑。

特殊情况:若提示 “找不到命令” 或执行失败

若输入wsl --install后出现 “无法将‘wsl’项识别为 cmdlet、函数、脚本文件或可运行程序的名称” 等报错,需手动启用功能:

  1. 保持管理员身份运行 PowerShell,输入以下命令并回车:

plaintext

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
  1. 命令执行完成后,再次重启电脑,即可完成核心功能启用。

步骤 2:安装 Linux 发行版(选择适合自己的版本)

  1. 电脑重启后,再次以管理员身份打开 PowerShell;
  2. 输入以下命令查看所有可在线安装的 Linux 发行版列表:

plaintext

wsl --list --online
  1. 执行后会显示完整的发行版清单,包含名称(NAME)和友好名称(FRIENDLY NAME),例如:| NAME | FRIENDLY NAME ||--------------------|------------------------------|| Ubuntu | Ubuntu || Debian | Debian GNU/Linux || kali-linux | Kali Linux Rolling || Ubuntu-22.04 | Ubuntu 22.04 LTS || Ubuntu-24.04 | Ubuntu 24.04 LTS || Oraclelinux_9_1 | Oracle Linux 9.1 |
  2. 选择想要安装的发行版,输入以下命令(将<分发名称>替换为实际选择的 NAME,例如 Ubuntu-22.04):

plaintext

wsl --install -d <分发名称>

示例(安装 Ubuntu 22.04 LTS):

plaintext

wsl --install -d Ubuntu-22.04
  1. 等待安装完成(网络通畅情况下约 5-10 分钟),首次启动时会提示 “正在安装,请稍候...”,随后要求创建 Linux 系统的用户名和密码(用户名建议使用小写字母,密码输入时不会显示,输入完成回车即可);
  2. 按照提示完成用户名和密码设置后,即可进入 Linux 命令行界面,说明发行版安装成功。

步骤 3:验证安装结果(确认是否可用)

  1. 保持 PowerShell 窗口打开(或重新打开任意 PowerShell 窗口,无需管理员权限);
  2. 输入以下命令查看已安装的 WSL 发行版及运行状态:

plaintext

wsl -l -v
  1. 若输出结果中显示发行版名称、版本号(通常为 2),且状态(STATE)为 “Running”,则说明 WSL 完全安装成功,可以正常使用;示例成功输出:

plaintext

  NAME            STATE           VERSION
* Ubuntu-22.04    Running         2

三、常见问题及解决方案(避坑指南)

问题 1:安装失败,提示 “WSL 2 需要启用虚拟机平台”

原因:WSL 2 依赖 Windows 的虚拟机平台功能,未启用时会导致安装失败。解决方案:

  1. 以管理员身份打开 PowerShell,输入以下命令:

plaintext

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
  1. 命令执行完成后,重启电脑,再次执行 WSL 安装命令即可。

问题 2:启动 WSL 报错 “0x80070057”

原因:Windows 系统版本过低,WSL 2 要求系统版本至少为 19041(Windows 10 20H1 及以上)或 Windows 11。解决方案:

  1. 按下Win+R,输入winver查看当前系统版本;
  2. 若版本低于 19041,需通过 Windows 更新升级系统:打开 “设置”→“Windows 更新”→“检查更新”,安装所有可用更新后重启电脑;
  3. 升级完成后,重新尝试启动 WSL。

问题 3:WSL 中无法访问网络(无法 ping 通外网、无法安装软件)

原因:Windows 防火墙限制、代理 / VPN 干扰或网络配置冲突。解决方案:

  1. 检查 Windows 防火墙:打开 “设置”→“隐私和安全性”→“Windows 安全中心”→“防火墙和网络保护”,确保允许 “适用于 Linux 的 Windows 子系统” 的出站连接;
  2. 关闭代理 / VPN:若当前开启了代理软件或 VPN,暂时关闭后重试;
  3. 重置 WSL 网络:以管理员身份打开 PowerShell,输入wsl --shutdown关闭所有 WSL 实例,然后重新启动 WSL 即可。

问题 4:离线安装包安装后无法启动

原因:未安装更新包或系统缺少依赖。解决方案:

  1. 先运行wsl_update_x64.msi更新包,完成后再运行wsl-install.msi主安装包;
  2. 安装完成后,按照 “步骤 1” 启用核心功能,重启电脑后再安装 Linux 发行版。

四、使用小贴士

  1. 首次使用 Linux 命令行,可输入sudo apt update更新软件源(需输入安装时设置的密码),方便后续安装各类 Linux 软件;
  2. WSL 与 Windows 系统共享文件:Windows 的 C 盘在 WSL 中的路径为/mnt/c/,可直接通过该路径访问 Windows 中的文件;
  3. 关闭 WSL 实例:无需手动关闭,退出命令行即可,或在 PowerShell 中输入wsl --shutdown强制关闭所有实例;
  4. 切换 WSL 版本:若需将 WSL 1 升级为 WSL 2,可输入wsl --set-version <分发名称> 2(例如wsl --set-version Ubuntu-22.04 2)。

如果在安装过程中遇到其他问题,欢迎在评论区留言,会及时回复解答!祝大家顺利使用 WSL,享受 Windows 与 Linux 无缝切换的便捷体验~

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐