WSL2是指Windows Subsystem for Linux的第二个版本,它提供了一个完整的在Windows上运行Linux应用程序的环境。主流的AI应用、模型提供商、AI相关框架、开源项目中的很大一部分均在Linux环境下运行,在Windows环境下安装WSL2是同时解决学习、开发和测试Linux项目而没有Linux环境的最优解。
前置教程
如想快速开始学习本教程,你可能需要先完成以下前置教程:
- Python+FastAPI在Windows环境下创建一个基础后端服务教程,本教程中会涉及Conda在Linux环境下的安装,此处假设你已经对Conda有一定的了解。
1. 下载Ubuntu
打开Microsoft Store,搜索并安装Ubuntu,此处以 22.04 LTS 版本为例:

2. 安装WSL2
如在运行安装Ubuntu过程中提示:
IInstalling, this may take a few minutes...
WslRegisterDistribution failed with error: 0x800701bc
Error: 0x800701bc WSL 2 ?????????????????? https://aka.ms/wsl2kernel
2.1 开启WSL2功能
在控制面板中开启WSL2功能
- 打开“控制面板” -> “程序” -> “启用或关闭Windows功能”
- 在弹出的窗口中,找到并勾选“适用于Linux的Windows子系统”、“虚拟机平台”、“Hyper-V”和“容器”
- 点击“确定”,系统将自动安装所需的组件
- 安装完成后,重启计算机

检查BIOS是否支持WSL2
打开任务管理器 -> 性能 -> CPU 确保虚拟化已启用

如显示未启用则需要在BIOS设置中开启虚拟化技术。
开启CPU虚拟化
- 重启计算机,在开机时按
F2、F10、Del或Esc进入 BIOS/UEFI 设置(不同品牌主板的按键不同) - 找到
Intel Virtualization Technology(Intel CPU)或SVM Mode(AMD CPU)选项 - 将其设置为
Enabled - 保存并退出 BIOS/UEFI 设置
3. 执行安装
在Microsoft Store中下载完成后,点击启动,即可安装Ubuntu,安装完成后,会提示设置用户名和密码,需要注意的是,密码不是明文,需要输入两次确认
最终出现如下提示,表示安装成功:
Installation successful!
eogee@DESKTOP-20230810:~$ # eogee 为用户名; DESKTOP-20230810 为计算机名
验证WSL2安装
wsl -l -v
预期输出应显示已安装的 Linux 发行版(如 Ubuntu)且版本为 2:
NAME STATE VERSION
* Ubuntu Running 2
如果输出中显示版本为 1,可以通过以下命令升级:
wsl --set-version Ubuntu 2
解释说明:
Ubuntu是一个基于Linux的开源发行版操作系统,提供了完整的Linux环境,包括命令行界面、文本编辑器、开发工具等。Ubuntu在大量的服务器中使用,是非常流行的Linux操作系统。
4. 下载安装Conda
关于Conda的概念及用法,你可以前往Python+FastAPI在Windows环境下创建一个基础后端服务教程进行回顾,这里不再赘述。
4.1 下载安装Conda
- 打开WSL2终端
- 运行以下命令下载并安装Conda:
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh # 下载Miniconda安装程序 bash Miniconda3-latest-Linux-x86_64.sh # 运行安装程序 source ~/.bashrc # 刷新环境变量 conda --version # 验证安装
4.2 创建Conda环境
运行以下命令创建一个名为eogee的Conda环境:
conda create -n eogee python=3.10 # 创建名为`eogee`的Python 3.10环境
conda activate eogee # 激活环境
4.3 配置Pip镜像源
为了确保在Conda环境中安装软件包时能够快速和稳定,建议配置Pip镜像源为清华镜像加速。运行以下命令配置Pip镜像源:
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple # 配置Pip镜像源为清华镜像加速
4.4 常用Conda命令
conda create -n eogee python=3.10:创建一个新的Conda环境,名为eogee,指定Python版本为3.10conda activate eogee:激活名为eogee的Conda环境conda install numpy:在当前环境中安装指定的软件包conda list:列出当前环境中安装的所有软件包conda env list:列出所有已创建的Conda环境conda remove -n eogee --all:删除名为eogee的Conda环境
举手提问