前置：

控制面板—程序—程序与功能 勾选 适用于Linux的Windows子系统 和 虚拟机平台（随后重启）

之后如果出现 由于未安装所需的特性，无法启动操作。 错误代码: Wsl/InstallDistro/Service/RegisterDistro/CreateVm/HCS/HCS_E_SERVICE_NOT_AVAILABLE是由于虚拟机平台未成功打开，可 以管理员身份 打开 PowerShell 执行以下命令：

1
2
3
4
5
6
7
8

# 启用 WSL 功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# 启用虚拟机平台
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 启用 Hyper-V（部分系统需要）
dism.exe /online /enable-feature /featurename:Hyper-V /all /norestart

安装过程：

1
2
3
4

wsl --install 			该步骤需要输入 用户名 和两次相同密码
wsl --list --verbose	可以查看可用的linux发行版
wsl --install Ubuntuxxx 选择发行版安装
wsl 					启动wsl

验证安装：

1
2

wsl --status
wsl --list --verbose

注意事项：

在第二步查看可用发行版时，容易出现 无法从“https://raw.githubusercontent.com/microsoft/WSL/master/distributions/DistributionInfo.json”提取列表分发。无法解析服务器的名称或地址 错误代码: Wsl/WININET_E_NAME_NOT_RESOLVED该问题，主要问题在于DNS污染，由于每次域名访问网站时会先查询本机的DNS，因此修改本机hosts文件即可，具体过程如下：

1 raw.githubusercontent.com - GitHub · Build and ship software on a single, collaborative platform · GitHub该网站中可查询最新可用的raw.githubusercontent.comde ipv4地址

2 以管理员权限打开本机hosts文件（一般位置在C:\Windows\System32\drivers\etc），文件最后加上 IP地址 raw.githubusercontent.com即可，无需重启。

额外操作：

1 vscode 安装插件wsl，能够更方便的进行项目开发。

2 wsl默认安装到C盘，该方案可以迁移至其它盘WSL默认安装目录 - CharyGao - 博客园。

推荐文章：

1 [无法访问https://raw.githubusercontent.com/xx的解决方案（2025.2亲测有效）_raw.githubusercontent com-CSDN博客](https://blog.csdn.net/qq_73162098/article/details/145330440?ops_request_misc=%7B%22request%5Fid%22%3A%2215197b98d7c0420d5d962a1e6fa77eed%22%2C%22scm%22%3A%2220140713.130102334.pc%5Fall.%22%7D&request_id=15197b98d7c0420d5d962a1e6fa77eed&biz_id=0&utm_medium=distribute.pc_search_result.none-task-blog-2~all~first_rank_ecpm_v1~rank_v31_ecpm-2-145330440-null-null.142^v102^control&utm_term=无法从“https%3A%2F%2Fraw.githubusercontent.com%2Fmicrosoft%2FWSL%2Fmaster%2Fdistributions%2FDistributionInfo.json”提取列表分发。无法解析服务器的名称或地址 错误代码%3A Wsl%2FWININET_E_NAME_NOT_RESOLVED&spm=1018.2226.3001.4187)

2 WSL默认安装目录 - CharyGao - 博客园