win11安装WSL2详细教程

已于 2025-07-13 14:53:24 修改
阅读量1k 收藏 13
点赞数 10
CC 4.0 BY-SA版权
分类专栏： Linux 文章标签： 深度学习 wsl
于 2025-07-10 12:07:33 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_42980908/article/details/149234053

一、WSL2安装

使用图形界面

  • 打开 控制面版
  • 访问 程序和功能 子菜单 打开或关闭Windows功能
  • 选择“适用于Linux的Windows子系统”与 “虚拟机平台”与“Hyper-V"
  • 点击“确定”
  • 重启
    在这里插入图片描述

搜索power shell ，右键“以管理员方式运行”，执行下面的两行命令

wsl --update
#将 WSL 默认版本设置为 WSL 2
wsl --set-default-version 2

在这里插入图片描述

二、下载Ubuntu系统

这里直接下载ubuntu镜像文件
https://learn.microsoft.com/en-us/windows/wsl/install-manual#downloading-distributions

在这里插入图片描述
用迅雷下载，速度飞快

下载完成后，会得到文件Ubuntuxxxx.AppxBundle
xxxxx根据由你下载的版本决定

将文件名，重命名为Ubuntuxxxx.zip，不用担心文件会损坏，改成zip就是为了方便解压而已。

解压之后，得到文件夹Ubuntuxxx

进入文件夹，找到文件Ubuntu_xxx_x64.appx，重命名为：Ubuntu_xxxx_x64.zip，然后解压。

得到文件夹Ubuntu_xxxx_x64

然后这个文件夹Ubuntu_xxxx_x64中有：
在这里插入图片描述
双击运行，让你输入用户名和密码

在这里插入图片描述

三、cuda安装

cuda版本安装cuda11.7（和windows系统上安装一样的版本）

https://developer.nvidia.com/cuda-toolkit-archive?login=from_csdn

在这里插入图片描述
在这里插入图片描述
然后它会生成安装命令：
在这里插入图片描述

这些命令需要在ubuntu命令行中运行，搜索power shell ，输入命令

wsl

即可进入ubuntu命令行

wget https://developer.download.nvidia.com/compute/cuda/repos/wsl-ubuntu/x86_64/cuda-wsl-ubuntu.pin
sudo mv cuda-wsl-ubuntu.pin /etc/apt/preferences.d/cuda-repository-pin-600
wget https://developer.download.nvidia.com/compute/cuda/11.7.0/local_installers/cuda-repo-wsl-ubuntu-11-7-local_11.7.0-1_amd64.deb
sudo dpkg -i cuda-repo-wsl-ubuntu-11-7-local_11.7.0-1_amd64.deb
sudo cp /var/cuda-repo-wsl-ubuntu-11-7-local/cuda-*-keyring.gpg /usr/share/keyrings/
sudo apt-get update
sudo apt-get -y install cuda

在执行完上述命令后，执行下面的系统环境配置：

echo 'export PATH=/usr/local/cuda/bin:$PATH' >> ~/.bashrc
echo 'export LD_LIBRARY_PATH=/usr/local/cuda/lib64:$LD_LIBRARY_PATH' >> ~/.bashrc
source ~/.bashrc

验证是否安装成功：

nvcc -V

显示下面的信息，表示成功
在这里插入图片描述

安装好的cuda在路径\wsl.localhost\Ubuntu\usr\local中：
在这里插入图片描述

四、cudnn安装

https://developer.nvidia.com/rdp/cudnn-archive

cuda11.7对应的cudnn版本是8.8.1.3，因此下载：
在这里插入图片描述
在这里插入图片描述
下载后的tar包在win系统中

在\home\syh新建cudnn文件夹：
将下载后的tar包通过复制粘贴到cudnn文件夹中：

然后打开ubuntu命令行，执行下面的命令：

tar -xvf cudnn-linux-x86_64-8.8.1.3_cuda11-archive.tar.xz
sudo cp cudnn-*-archive/include/cudnn*.h /usr/local/cuda/include
sudo cp -P cudnn-*-archive/lib/libcudnn* /usr/local/cuda/lib64 
sudo chmod a+r /usr/local/cuda/include/cudnn*.h /usr/local/cuda/lib64/libcudnn*

验证是否安装成功，输入如下命令，显示如下图即安装成功

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

在这里插入图片描述

安装Anaconda

https://repo.anaconda.com/archive/
在这里插入图片描述
如果这样直接下载会下载到win中，我们直接在ubuntu的命令行中执行下面的命令：

wget -P /tmp https://repo.anaconda.com/archive/Anaconda3-2023.03-1-Linux-x86_64.sh

会下载到tmp文件夹中

然后安装Anaconda3：

bash /tmp/Anaconda3-2023.03-1-Linux-x86_64.sh

按回车阅读用户协议

在这里插入图片描述

输入yes。

在这里插入图片描述输入安装位置，默认为/home/用户名/anaconda3。

在这里插入图片描述
输入yes，运行conda初始化。
在这里插入图片描述

重新打开一个conda命令行，前面会自动进入base环境，证明安装成功：
在这里插入图片描述

五、Ubuntu换源

步骤一、apt换源
打开清华镜像官网
https://mirrors.tuna.tsinghua.edu.cn/

在这里插入图片描述
在这里插入图片描述

在这里插入图片描述
使用如下命令进入配置文件：

sudo gedit /etc/apt/sources.list

将里面的文本替换为下面的代码，然后保存

# 默认注释了源码镜像以提高 apt update 速度，如有需要可自行取消注释
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-updates main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-updates main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-backports main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-backports main restricted universe multiverse

# 以下安全更新软件源包含了官方源与镜像站配置，如有需要可自行修改注释切换
deb http://security.ubuntu.com/ubuntu/ noble-security main restricted universe multiverse
# deb-src http://security.ubuntu.com/ubuntu/ noble-security main restricted universe multiverse

# 预发布软件源，不建议启用
# deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-proposed main restricted universe multiverse
# # deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-proposed main restricted universe multiverse

ps:清华源镜像会不定期更新,所以最好按作者所说步骤去复制此镜像源

然后更新源：

sudo apt update # apt更新

步骤二、conda换源
使用如下代码即可换源：

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/linux-64/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/linux-64/
conda config --set show_channel_urls yes

步骤三、pip换源
创建pip.conf文件

cd ~/.pip

如果提示目录不存在的话,我们要自行创建一个,再进入目录

mkdir ~/.pip
cd ~/.pip

在.pip目录下创建一个pip.conf文件

touch pip.conf

编辑pip.conf文件

sudo gedit ~/.pip/pip.conf

打开pip.conf文件窗口,将以下内容复制到文件中:

[global] 
index-url = http://pypi.douban.com/simple 
[install] 
trusted-host=pypi.douban.com

ctrl+s保存退出

六、创建虚拟环境，安装pytorch和torchvision

创建虚拟环境：

conda create -n your_env_name python=x.x
例如：conda create -n ghrp python=3.8

查看虚拟环境：

conda env list

切换虚拟环境：

conda activate your_env_name

在切换到你虚拟环境后，安装Pytorch，对应版本下载命令在官网中查找
https://pytorch.org/get-started/previous-versions/

我安装这个版本的：
在这里插入图片描述

pip install torch==1.13.1+cu117 torchvision==0.14.1+cu117 torchaudio==0.13.1 --extra-index-url https://download.pytorch.org/whl/cu117

安装完成之后可以在命令行中输入python，依次输出以下命令，输出如下图所示则表明安装成功:

import torch
torch.__version__
torch.cuda.is_available()
torch.version.cuda

在这里插入图片描述

七、Pycharm远程WSL2

我的配置是代码和**解释器(conda环境)**都在WSL中

点击 File > Open
在这里插入图片描述

选择位于 WSL 里面的项目
在这里插入图片描述

点击Pycharm 右下角的 Python Interpreter selector，选择 On WSL…
在这里插入图片描述
点击 Next
在这里插入图片描述
使用conda环境
在这里插入图片描述

选择创建的conda虚拟环境
在这里插入图片描述

八、vscode远程wsl

点击左下方图标【Open a Remote Windows】
在这里插入图片描述
弹出【远程连接】浮窗 ，选择【Connect to WSL】,等待几分钟即可连接到wsl的ubuntu系统
在这里插入图片描述
点击左下方的WSL的ubuntu子系统，弹出【远程连接】浮窗，点击【Close Remote Connection】选项就可以退出WSL的ubuntu子系统。
在这里插入图片描述
直接在设置（ctrl + shift + p）里面搜索，点击“Python:Select Interpreter”选项，然后选择自己对应的虚拟环境即可

(Win10或Win11)WSL最全最详细安装、美化、迁移、卸载教程
DN金猿的博客
09-04 6152
安装适用于 Linux 的 Windows 子系统 必须先启用“适用于 Linux 的 Windows 子系统”可选功能，然后才能在 Windows 上安装 Linux 分发版。 以管理员身份打开 PowerShell 并运行： PowerShell复制 dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart 若要仅安装 WSL 1，现在应重启计算机并继续安装
篇二：在win11上通过WSL2安装ubuntu
H F的专栏
06-03 532
确保你的Windows系统版本为Windows 10 21H1及以上，并且已启用WSL2功能和虚拟机平台功能。：在“启用或关闭 Windows 功能”，启用“虚拟机平台”和“适用于Linux的Windows子系统”功能。在Microsoft Store的搜索框中输入“wsl”，选择Ubuntu 20.01.6 LTS进行安装。你可以直接在WSL2的Ubuntu中安装和运行图形化应用，如浏览器。方法二：win+R-->输入“CMD”-->输入“wsl”：打开“启用或关闭 Windows 功能”
windows11 搭建 WSL2 运行环境（2024）
qq_39316962的博客
06-24 1万+
【2024最新】一次搞定 Windows 11+WSL2+Ubuntu+Miniconda3+PyTorch 安装环境配置
windows11 安装WSL2全流程
热门推荐
dddeee的专栏
05-18 15万+
本文介绍了win11安装wsl做开发环境
windows11 安装WSL2详细过程
最新发布
weixin_30767323的博客
06-20 147
时间来到 2017 年，事情正在起变化。微软正式发布了「适用于 Linux 的 Windows 子系统」，即人们熟知的 Windows Subsystem for Linux，简称 WSL。在 2019 年，微软又基于 Hyper-V 架构的部分功能，推出了全新的 WSL 2。它能够在一个高度优化的虚拟化中运行完整的 Linux 内核。
windows11安装WSL2
m0_56643625的博客
02-28 2957
控制面板->程序->启用或关闭 windows 功能，开启 Windows 虚拟化和 Linux 子系统（WSL2)以及Hyper-V。将WSL的默认版本从1切换到2，以便在启动新的Linux发行版时使用WSL 2版本。WSL2：是适用于Linux的Windows子系统体系结构的新版本，都完成上面步骤后打开Ubuntu会打开以下界面：设置账号还有密码。解决：右键以管理员身份打开windows PowerShell。检查是否已经安装Linux的windows子系统。查看列出所有安装的WSL。
Windows 11 安装 WSL2
Linux驱动开发工程师，熟悉Linux/Android底层驱动、TP、显示、IIC、网络等通用外设调试适配，Linux上层应用开发，熟悉瑞芯微、全志、恩智浦等平台。
03-22 2207
编译报错找不到GLIBCXX，从wsl导入镜像，更换高版本ubuntu
win11安装WSL2（以拯救者游戏本为例，附可能出现的问题及解决）
一个苦逼研究僧的博客
02-25 1万+
  先附上微软官方的安装教程，如果跟着这个教程安装没问题的话，恭喜你，可以关闭这篇文章了。 传送门   上面的链接需要略微繁琐，如果想要一步到位（偷懒）的话，推荐直接去微软商店里试试直接安装，比如这样，打开微软商店直接搜Ubuntu，根据喜好选择Ubuntu版本，建议20.04右上角有安装，点击之后等待就完事儿了，不出意外的话就能直接安装好。如果有问题出现，往下看   下面记录一些可能碰到的问题。    1. 提示系统虚拟功能没开。需要进BIOS开启虚拟技术，我的笔记本CPU是AMD的，所以名字跟英特尔的
win11安装wsl2
chamu99的博客
12-01 594
安装wsl2中的Ubuntu22.04版本。
[ INSTALL ] Win11安装WSL1详细流程（附安装包）
庐陵居士
06-04 1626
输入以下后回车：dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart。Win+r 中输入control 打开控制面板。
【工具学习】Win11安装WSL并配置深度学习环境
Vehicle_jyw的博客
08-04 1147
来查找可用的发行版，也可以加载本地发行版文件。微软目前提供了单个指令一键安装WSL，打开PowerShell，然后输入。指定发行版，可以通过运行。本文选择安装20.04。
在Windows 11 中安装和使用 WSL 2
MAVER1CK的博客
06-28 5210
在Windows上安装好后，只要设置好TUN模式，无需在wsl中进行任何设置，即可使用Windows上开启的代理。通过导入和导出，可以实现 WSL 发行版的备份、迁移，类似于 Docker 中将容器导出为。如果能成功打开，那么第一次打开时需要设置用户名和密码，设置好后就能正常使用了。新建一个文件夹用于存储导入后的发行版的数据，例如我创建的文件夹路径为。类似，先用VSCode连接到wsl，再在左侧的远程资源管理器中选择。中有特定分发的exe文件，那么输入文件名如。这样会删除原来的容器，然后创建新的容器，但。
【2024】Windows 11 安装WSL2并搭建深度学习环境（Docker，Pytorch）
tao355667
01-15 1万+
Windows 11下，在WSL2上搭建深度学习环境
Windows 11 安装 WSL2与配置的一些注意事项
scott198512的博客
05-22 1536
wsl子系统安装与配置问题解决
win11 install wsl2
weixin_35756373的博客
01-09 538
在 Windows 11 上安装 WSL 2 的步骤如下： 首先，确保你的 Windows 版本是 Windows 11 或者更新的版本，并且支持 WSL 2。 然后，打开“设置”应用，在“更新与安全”页面的“开发人员选项”中，启用“Windows Subsystem for Linux”。 在“应用商店”中搜索并安装 WSL 2 安装程序。 在命令提示符窗口中，运行以下命令来升级现有的 ...
Win11 安装 WSL2 实现便捷 Linux 开发环境
王清欢的博客
04-08 1万+
我们日常工作学习中有很多涉及与 Linux 系统的交互，但是如果用的是 Win 系统通常需要构建虚拟机或者安装双系统来实现，但是 WSL 的出现让在这种需求更易实现了。WSL 全称是（Windows Subsystem for Linux，适用于Linux的Windows子系统），使用 WSL 一方面可以享受 Windows 系统的稳定性，同时可以并存 Linux 环境，还可以直接互相调用，极大地方便了开发人员进行开发工作。
Windows11安装WSL2 笔记240726
kfepiza的博客
07-26 2408
以管理员身份打开控制台输入如果什么也没有,说明系统还未安装WSL , 执行进行安装安装完成后, 再次执行可看到默认版本: 2 当前计算机配置不支持 WSL1。若要使用 WSL1，请启用“Windows Subsystem forLinux”可选组件。当前计算机配置不支持 WSL2。请启用“虚拟机平台”可选组件，并确保在 BIOS 中启用虚拟化。通过运行以下命令启用“虚拟机平台”: wsl.exe --install --no-distribution 有关信息，请访问。
Windows11安装WSL2并运行项目：Parallel-Meta Suite
Nidhoggblack的博客
11-13 1341
找到控制面板-程序-程序和功能，选中“适用于Linux的Windows子系统”，然后点击确定1.2打开PowerShell以管理员身份运行这里的用户名需要全小写，不然会报错。
win11wsl安装教程
02-22
### Windows 11 WSL 安装指南 #### 启用 WSL 功能 为了在 Windows 11 上安装 WSL，首先需要启用必要的功能。这可以通过 PowerShell 来完成： ```powershell dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart ``` 上述命令会启动两个重要的组件：Windows Subsystem for Linux (WSL) 和 Virtual Machine Platform[^2]。 #### 更新到 WSL 2 确保系统已经更新至最新的 WSL 2 内核版本。通过以下命令下载并安装最新内核包： ```powershell wsl --update ``` 此命令将自动获取适用于当前系统的最佳 WSL 2 内核版本。 #### 设置默认版本为 WSL 2 为了让新安装的任何 Linux 发行版都使用 WSL 2 而不是旧版本，默认设置需调整如下： ```powershell wsl --set-default-version 2 ``` 这条指令设定了之后所有的 Linux 发行版都将基于更高效的 WSL 2 技术运行。 #### 安装 Ubuntu 或其他 Linux 发行版 微软商店提供了多种官方支持的 Linux 发行版供选择。对于希望体验 GNOME 桌面环境的情况，推荐安装带有图形界面支持的 Ubuntu 版本。可通过 Microsoft Store 应用程序搜索 "Ubuntu" 并点击安装按钮来轻松实现这一点[^1]。 #### 创建 .wslconfig 文件优化性能 为了进一步提升用户体验，在用户的个人资料目录下创建 `.wslconfig` 文件能够帮助自定义一些全局参数。例如，可以指定内存分配量、CPU 使用率等选项以适应不同的应用场景需求。具体做法是在 `%UserProfile%` 目录中新建名为`.wslconfig` 的纯文本文件，并编辑其内容如下所示[^4]: ```ini [wsl2] memory=8GB # 分配给 WSL 2 VM 的最大 RAM 数量 processors=4 # 可由 WSL 2 VM 使用的最大处理器核心数 swap=0 # 不使用交换空间；可根据实际硬件情况适当增加大小 ``` 保存更改后重启计算机使新的配置生效。 #### 测试安装成果 最后一步是验证整个过程是否成功。打开命令提示符或 PowerShell 输入 `wsl` 命令进入刚刚安装好的 Linux 环境。如果一切正常，则意味着现在已经可以在 Windows 11 中流畅地运行 Linux 工具和服务了。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值