Windows11环境下配置vscode与wsl2

最新推荐文章于 2025-05-28 21:45:41 发布

ya哑巴

最新推荐文章于 2025-05-28 21:45:41 发布

阅读量4.4k

点赞数 3

CC 4.0 BY-SA版权

分类专栏：问题解决文章标签： vscode visual studio code linux

本文链接：https://blog.csdn.net/weixin_42705114/article/details/121357144

问题解决专栏收录该内容

5 篇文章

订阅专栏

本文详细指导如何在Windows 11环境下配置Visual Studio Code (VSCode) 与Windows Subsystem for Linux (WSL2)，包括设置控制面板选项、下载Ubuntu、关联WSL、安装GCC、解决常见问题及关联WSL到VSCode的过程。适合Linux开发者在Windows上无缝工作。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

借用官方大大的介绍：WSL是适用于 Linux 的 Windows 子系统，可让开发人员按原样运行 GNU/Linux 环境 - 包括大多数命令行工具、实用工具和应用程序 - 且不会产生传统虚拟机或双启动设置开销。

附上官方教程：开始使用 Visual Studio Code 与适用于 Linux 的 Windows 子系统

为了避免系统版本不一致导致出现问题，先附上我的系统版本：
按键win+R，输入winver可查看自己的windows版本。
在这里插入图片描述
我的版本：

开始正题~~

1. 修改windows程序功能

1.1 进入控制面板-程序

控制面板-程序-启用或关闭windows功能

1.2 打开两个选项

在这里插入图片描述

2. 下载ubuntu

去Microsoft Store中搜索Linux，选择自己合适的Ubuntu系统进行安装。
注：若想使用gcc 5 版本，需要手动安装ubuntu 16.04，否则安装高版本的ubuntu之后降gcc版本比较麻烦，请拉到本文最后查看ubuntu16.04下载教程。

在这里插入图片描述
安装成功后，会提示进行用户名和密码设置，官方文档中也写明与windows独立，自己记住就好。成功后记得update一下。

update完成之后，安装wsl，使用官方的指令：

wsl --insatll

在这里插入图片描述

在命令行中可能会提示下面的指令，输入执行该指令安装就好。

sudo apt insatll wsl

注：
当然，在应用商店安装完成ubuntu，打开之后会出现各种报错的情况，我就出现了0x8007019e、0x80370102这几种(解决了一个又有另一个错误出现)。
尝试了好多种办法，我最后成功的解决办法：
1. 检查以上两个开关是否开启，开启后是否立马进行重启计算机；
2. 卸载ubuntu重新安装

当然，WSL安装这篇博客最后的一些解决方法也可以尝试，我是试了没有效果。

3. 关联VsCode并运行

想要关联VsCode，需要执行以下指令进入VsCode。

code  .

在这里插入图片描述
进入VsCode后，检查一下用户名上是否有 [WSL:UBUNTU-xxx]

第一次进入应该是没有的，因为需要在VsCode下也需要安装wsl，步骤：
商店–搜索remote-wsl，安装后重启VsCode即可。

安装好后，在VsCode下就会显示用户名+[WSL:UBUNTU-xxx] 了，此时的编译环境就是在Linux下了。

接下来导入工程，因为windows和ubuntu是两个不同的系统，所以需要使用mnt挂载windows的文件。
在Vscode界面，文件-打开文件夹，点击mnt，之后会看到c d e这样的盘符，这就是本地电脑的C盘 D盘 E盘了，然后选择你的工程所在的位置，添加。
在这里插入图片描述

如果需要进行cmake编译，需要在扩展中安装cmake。
注意：这里是linux下的cmake，与windows下的有所区别。

也可以使用sudo进行安装。

然后进行cmake编译，结果提示没有编译器。。。

在这里插入图片描述
那么就直接install gcc和g++解决

sudo apt install gcc

sudo apt install g++

最后，关联并编译成功！
在这里插入图片描述
如果make时遇到arm-linux-gnueabi-gcc: Command not found错误，执行 sudo apt-get install gcc-arm* 解决。

------------------------------------------------分割线---------------------------------------------
如果有对gcc和g++编译器有版本要求的，例5.4.0版本，需要手动下载安装ubuntu 16.04版本，直接点击蓝色链接下载(如果下载速度比较慢或失败，可以尝试使用迅雷下载)，下载完成后双击会进入MicroSoft Store自动安装，之后的步骤和前面一样。