【个人经验】Windows10/11使用WSL和Vscode配置C/C++环境

pyzyd

第一次发技术贴，不会排版，见谅

Windows10/11使用WSL和Vscode配置C/C++环境

一、安装WSL：

什么是  WSL ？

WSL（ Windows Subsystem for Linux ）是一项由微软开发的兼容层功能。它允许你在原生的 Windows 系统上直接运行 GNU/Linux 环境（包括大多数命令行工具、实用程序和应用程序），而无需传统的虚拟机或双启动设置。

1.前置条件：

对 Windows 的要求: Windows10 ，需版本 2004 及更高版本（内部版本 19041 及更高）；Windows11。检查版本号：按 Win + R  键，输入 winver 并回车。弹出的窗口会告诉你具体的版本号。
开启虚拟化：CPU 必须支持并在 BIOS/UEFI 中开启虚拟化功能（VT-x/AMD-V）。

可以在任务管理器中查看是否已开启：



启用功能：需要在 Windows 中启用“适用于 Linux 的 Windows 子系统”和“虚拟机平台” 这两个可选功能。按照提示重启电脑（打开控制面板->程序->启用或关闭Windows功能）




2.安装方法
微软官方教程
1.命令行安装

打开终端，输入“wsl --install”命令即可直接安装，等待时间稍长，可以开代理提速。
可以通过“wsl --instal -d Ubuntu” -d命令选择Linux发行版，默认是Ubuntu。

2.微软商店安装。
在 Microsoft Store 里搜索 WSL 会出现许多个Linux发行版，自己选一个安装，
安装好之后会让你设置用户名和密码，建议用户名英文小写，设置一个自己能记住的密码，注意：输入密码时是不会显示的！
然后就进入了Linux界面。


3.换国内源

通过 “lsb_release”命令显示Ubuntu版本


使用 sudo 命令第一次需要输入密码。
若Ubuntu版本号大于等于24.04，请使用以下指令：

1. sudo cp /etc/apt/sources.list.d/ubuntu.sources /etc/apt/sources.list.d/ubuntu.sources.bak
   
2. sudo sed -i "s|http://.*archive.ubuntu.com|[url]https://mirrors.tuna.tsinghua.edu.cn[/url]|g" /etc/apt/sources.list.d/ubuntu.sources
   
3. sudo sed -i "s|http://.*security.ubuntu.com|[url]https://mirrors.tuna.tsinghua.edu.cn[/url]|g" /etc/apt/sources.list.d/ubuntu.sources

复制代码

若Ubuntu版本号小于24.04，请使用以下指令：

1. sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
   
2. sudo sed -i "s|http://.*archive.ubuntu.com|[url]https://mirrors.tuna.tsinghua.edu.cn[/url]|g" /etc/apt/sources.list
   
3. sudo sed -i "s|http://.*security.ubuntu.com|[url]https://mirrors.tuna.tsinghua.edu.cn[/url]|g" /etc/apt/sources.list

复制代码

wsl的安装到这里，想进看细节的或者一步了解的参考下面的链接
【2025】最新WSL2教程 + GUI桌面环境搭建
从0开始安装WSL


二、使用Vscode
我是在Windows上安装的Vscode，如果想在wsl中安装Vscode就自己摸索，我也不会，毕竟是个人经验
1. 安装 Vscode
官网链接：Visual Studio Code - Code Editing. Redefined
或者微软链接：Visual Studio: 面向软件开发人员和 Teams 的 IDE 和代码编辑器

2.安装wsl插件

安装好之后打开Vscode，点击插件


可以安装一个Chinese插件汉化Vscode



在搜索框输入wsl搜索，选择Microsoft发布的安装




启动连接：你有以下几种方式建立连接：
方式一（最常用）：在 VSCode 左下角，你会看到一个绿色的按钮（类似 ><），点击它。或者按 Ctrl+Shift+P 打开命令面板，然后输入 WSL: Connect to WSL 或 WSL: Connect to WSL using Distro... 并选择。


点击这里进行查看


方式二（从终端）：打开你的 WSL 终端，进入你的项目目录，然后输入命令 code .。VSCode 会自动启动（如果还没运行的话）并直接连接到当前的 WSL 目录。
打开Windows终端，输入wsl命令进入wsl终端，或者点击下三角图案选择Ubuntu。


输入“cd ~”命令转到主文件夹，创建一个文件夹用于写代码，“mkdir CppProject”回车,"cd CppProject"回车,再创建一个‘Test’文件夹 “mkdir Test”，输入"code Test"并回车，就打开Vscode了




三、创建C/C++环境
在打开的Vscode中再点击插件搜索C/C++，下载下面三个插件，如果已经在本地已安装可以在本地安装的插件里找到点击“在WSL中安装”。



1. 下载编译器

在打开的WSL终端中输入以下命令下载 gcc ，gdb

1. sudo apt update
   
2. sudo apt install build-essential gdb

复制代码

安装完成后，通过以下命令检查版本，以确保安装成功：

1. # 检查 gcc 版本
   
2. gcc --version
   
3. 
   
4. # 检查 gdb 版本
   
5. gdb --version

复制代码

如果成功，终端会显示类似 gcc (Ubuntu 11.4.0-1ubuntu1~22.04) 11.4.0 的版本信息。

这样，编译器的问题就解决了


配置 C/C++ 环境
可以用翻译插件查阅
推荐插件官方的教程：在 VS Code 中使用 C++ 和 WSL --- Using C++ and WSL in VS Code


在打开的Vscode中新建一个 c 或者 cpp 文件，写好 helloworld 的代码，直接点击运行



我选择的是g++编译，如果是.c文件可以选择gcc，然后转到终端，可以查看到输出，第二行是正常的，在终端直接编译运行就不会出现第二行这样的信息

1. Hello World
   
2. [1] + Done                       "/usr/bin/gdb" --interpreter=mi --tty=${DbgTerm} 0<"/tmp/Microsoft-MIEngine-In-sc1h3vyc.3ja" 1>"/tmp/Microsoft-MIEngine-Out-2bowl2ad.drg"

复制代码

然后可以配置调试




可以生成一个 launch.json 文件用于调试和自定义。


可以通过在命令面板（快捷键：[backcolor=rgba(0, 0, 0, 0.08)]Ctrl+Shift+P ）中运行命令  C/C++ : 编辑配置（UI） 来查看  C/C++ 配置界面。
会生成一个 c_cpp_properties.json 文件来保存你的更改




好了，现在你可以愉快地用 Vscode 写 C/C++ 了。

如果你想用 Vscode 写 C/C++ 项目的话可以在 wsl 中安装 cmake
在wsl中输入命令 sudo apt install cmake

1. sudo apt install cmake

复制代码

检查 cmake 安装成功

1. cmake --version

复制代码

更多参考(我不是很懂)：
C++游戏开发 | 从入门到精通
【C++】Cmake使用教程（看这一篇就够了）-CSDN博客

在 Linux 上开始使用 CMake 工具 --- Get started with CMake Tools on Linux
使用 CMake 快速入门创建 CMake hello world 项目 --- Create a CMake hello world project with CMake Quick Start

gpa5031

学习了，历害

不二如是

非常全面

不二如是

排版可以参考这篇帖子：申精#文章格式建议【官方指导】

pyzyd

不二如是 发表于 2025-8-29 16:06
排版可以参考这篇帖子：申精#文章格式建议【官方指导】

鱼小二

内容好好，就是图片有点太大大大了

雲裏霧裏

写得不错，很详细，好好学习了

六翻了

6