WSL2是指Windows Subsystem for Linux的第二个版本,它提供了一个完整的在Windows上运行Linux应用程序的环境。主流的AI应用、模型提供商、AI相关框架、开源项目中的很大一部分均在Linux环境下运行,在Windows环境下安装WSL2是同时解决学习、开发和测试Linux项目而没有Linux环境的最优解。

前置教程

如想快速开始学习本教程,你可能需要先完成以下前置教程:

1. 下载Ubuntu

打开Microsoft Store,搜索并安装Ubuntu,此处以 22.04 LTS 版本为例:

Microsoft Store中下载Ubuntu

2. 安装WSL2

如在运行安装Ubuntu过程中提示:

IInstalling, this may take a few minutes...
WslRegisterDistribution failed with error: 0x800701bc
Error: 0x800701bc WSL 2 ?????????????????? https://aka.ms/wsl2kernel
这表明WSL2内核未安装,需要下载并安装WSL2内核。

2.1 开启WSL2功能

在控制面板中开启WSL2功能

  1. 打开“控制面板” -> “程序” -> “启用或关闭Windows功能”
  2. 在弹出的窗口中,找到并勾选“适用于Linux的Windows子系统”、“虚拟机平台”、“Hyper-V”和“容器”
  3. 点击“确定”,系统将自动安装所需的组件
  4. 安装完成后,重启计算机

开启WSL2功能示意图

检查BIOS是否支持WSL2

打开任务管理器 -> 性能 -> CPU 确保虚拟化已启用

在控制面板中开启WSL2功能

如显示未启用则需要在BIOS设置中开启虚拟化技术。

开启CPU虚拟化

  1. 重启计算机,在开机时按 F2F10DelEsc 进入 BIOS/UEFI 设置(不同品牌主板的按键不同)
  2. 找到 Intel Virtualization Technology(Intel CPU)或 SVM Mode(AMD CPU)选项
  3. 将其设置为 Enabled
  4. 保存并退出 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

  1. 打开WSL2终端
  2. 运行以下命令下载并安装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.10
  • conda activate eogee:激活名为eogee的Conda环境
  • conda install numpy:在当前环境中安装指定的软件包
  • conda list:列出当前环境中安装的所有软件包
  • conda env list:列出所有已创建的Conda环境
  • conda remove -n eogee --all:删除名为eogee的Conda环境