手把手教你安装和配置WSL2:从零搭建Linux开发环境

前言

WSL2(Windows Subsystem for Linux 2)是微软推出的轻量级Linux子系统,允许开发者在Windows上无缝运行Linux工具和环境。本文将从安装到配置,一步步教你如何搭建WSL2,并解决常见问题。

一、windows设置

打开win搜索栏搜索windows功能

  1. 使用”Windows+R“快捷键,在打开的「运行」窗口中输入"optionalfeatures"打开「Windows 功能」
     

  2. 打开虚拟机平台适用于linux的windows子系统、Hyper-v

 

二、升级为最新版本的 WSL

wsl --update       # 更新

并设置为wsl2

wsl --set-default-version 2

三、安装ubuntu22.04

#wsl --list --online查询可在线下载的Linux发行版列表
C:\Users\0>wsl --list --online
以下是可安装的有效分发的列表。
使用 'wsl.exe --install <Distro>' 安装。

NAME                            FRIENDLY NAME
SUSE-Linux-Enterprise-15-SP5    SUSE Linux Enterprise 15 SP5
SUSE-Linux-Enterprise-15-SP6    SUSE Linux Enterprise 15 SP6
Ubuntu                          Ubuntu
Ubuntu-24.04                    Ubuntu 24.04 LTS
kali-linux                      Kali Linux Rolling
openSUSE-Tumbleweed             openSUSE Tumbleweed
openSUSE-Leap-15.6              openSUSE Leap 15.6
Debian                          Debian GNU/Linux
Ubuntu-18.04                    Ubuntu 18.04 LTS
Ubuntu-20.04                    Ubuntu 20.04 LTS
Ubuntu-22.04                    Ubuntu 22.04 LTS
OracleLinux_7_9                 Oracle Linux 7.9
OracleLinux_8_7                 Oracle Linux 8.7
OracleLinux_9_1                 Oracle Linux 9.1

#命令只有一行,以管理员身份运行,如下:
wsl --install -d <Distribution Name>


#例如我想要安装Ubuntu-22.04
wsl --install -d Ubuntu-22.04

#查看已安装的 Linux 发行版本
wsl -l --all -v
C:\Users\0>wsl -l --all -v
  NAME            STATE           VERSION
* Ubuntu-22.04    Stopped         2

#启动命令
C:\Users\0>wsl
chk@DESKTOP-D5JINC7:/mnt/c/Users/0$

四、linux 子系统迁移其它盘

#关闭正在运行的子系统
C:\Users\0>wsl --shutdown

C:\Users\0>wsl -l --all -v
  NAME            STATE           VERSION
* Ubuntu-22.04    Stopped         2


#迁移到目的盘
以导出到D 盘为例
wsl --export <发行版 Linux> <tar包路径>
C:\Users\0>wsl --export Ubuntu-22.04 D:\wsl\ubuntu22.04.tar

导出完成之后,将原有的Linux注销
wsl --unregister <发行版Linux>
C:\Users\0>wsl --unregister Ubuntu-22.04
正在注销。
操作成功完成。
C:\Users\0>wsl -l --all -v
适用于 Linux 的 Windows 子系统没有已安装的分发。
可通过安装包含以下说明的分发来解决此问题:
使用“wsl.exe --list --online' ”列出可用的分发
和 “wsl.exe --install <Distro>” 进行安装。


然后将导出的文件放到需要保存的地方
wsl --import <子系统名称> <安装位置> <tar文件名>
C:\Users\0>wsl --import Ubuntu-22.04 D:\wsl\Ubuntu-22.04 D:\wsl\ubuntu22.04.tar  --version 2
C:\Users\0>wsl -l -v
  NAME            STATE           VERSION
* Ubuntu-22.04    Stopped         2

五、安装显卡驱动

1.利用ubuntu官方源安装

root@DESKTOP-TUR5ISE:~# nvidia-smi
Command 'nvidia-smi' not found, but can be installed with:
apt install nvidia-utils-510         # version 510.60.02-0ubuntu1, or
apt install nvidia-utils-510-server  # version 510.47.03-0ubuntu3
apt install nvidia-utils-390         # version 390.157-0ubuntu0.22.04.2
apt install nvidia-utils-418-server  # version 418.226.00-0ubuntu5~0.22.04.1
apt install nvidia-utils-450-server  # version 450.248.02-0ubuntu0.22.04.1
apt install nvidia-utils-470         # version 470.223.02-0ubuntu0.22.04.1
apt install nvidia-utils-470-server  # version 470.223.02-0ubuntu0.22.04.1
apt install nvidia-utils-525         # version 525.147.05-0ubuntu0.22.04.1
apt install nvidia-utils-525-server  # version 525.147.05-0ubuntu0.22.04.1
apt install nvidia-utils-535         # version 535.129.03-0ubuntu0.22.04.1
apt install nvidia-utils-535-server  # version 535.129.03-0ubuntu0.22.04.1
root@DESKTOP-TUR5ISE:~# apt install nvidia-utils-535
chk@DESKTOP-D5JINC7:~$ nvidia-smi
Sun Feb 16 20:24:06 2025       
+---------------------------------------------------------------------------------------+
| NVIDIA-SMI 535.183.01             Driver Version: 572.16       CUDA Version: 12.8     |
|-----------------------------------------+----------------------+----------------------+
| GPU  Name                 Persistence-M | Bus-Id        Disp.A | Volatile Uncorr. ECC |
| Fan  Temp   Perf          Pwr:Usage/Cap |         Memory-Usage | GPU-Util  Compute M. |
|                                         |                      |               MIG M. |
|=========================================+======================+======================|
|   0  NVIDIA GeForce RTX 2080 Ti     On  | 00000000:81:00.0  On |                  N/A |
| 41%   37C    P8              45W / 250W |    683MiB / 22528MiB |      4%      Default |
|                                         |                      |                  N/A |
+-----------------------------------------+----------------------+----------------------+
                                                                                         
+---------------------------------------------------------------------------------------+
| Processes:                                                                            |
|  GPU   GI   CI        PID   Type   Process name                            GPU Memory |
|        ID   ID                                                             Usage      |
|=======================================================================================|
|    0   N/A  N/A        33      G   /Xwayland                                 N/A      |
+---------------------------------------------------------------------------------------+

六、安装CUDA

1.ubuntu换源
sudo vim /etc/apt/sources.list
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse
deb http://security.ubuntu.com/ubuntu/ jammy-security main restricted universe multiverse
2.安装
https://developer.nvidia.com/cuda-toolkit-archive

wget https://developer.download.nvidia.com/compute/cuda/repos/wsl-ubuntu/x86_64/cuda-keyring_1.1-1_all.deb
sudo dpkg -i cuda-keyring_1.1-1_all.deb
sudo apt-get update
sudo apt-get -y install cuda-toolkit-12-8
3.在~/.bashrc文件中配置环境变量
sudo vim ~/.bashrc

大写I进入编辑模式,在末尾将以下代码复制进去,然后按esc推出编辑模式,输入:wq保存并退出

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/cuda-12/lib64
export PATH=$PATH:/usr/local/cuda-12/bin
export CUDA_HOME=$CUDA_HOME:/usr/local/cuda-12

输入source ~/.bashrc刷新环境变量,输入nvcc -V查看cuda是否已经安装成功

七、安装cudnn

1.下载

访问cuDNN Archive | NVIDIA Developer选择适合的cudnn版本,选择Local Installer for Linux x86_64(tar)版本下载,将安装包解压并复制到用户目录下。

cuDNN Archive | NVIDIA Developer 

2.安装

依次键入如下代码安装:

cd cudnn-linux-x86_64-8.9.7.29_cuda11-archive/
sudo cp -r lib/* /usr/local/cuda-11.8/lib64/
sudo cp -r include/* /usr/local/cuda-11.8/include/
sudo chmod a+r /usr/local/cuda-11.8/lib64/libcudnn*
sudo chmod a+r /usr/local/cuda-11.8/include/cudnn* 

验证是否成功安装

cat /usr/local/cuda-11.8/include/cudnn_version.h | grep CUDNN_MAJOR -A 2